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1  INTRODUCTION  :  VEHICLES  CSCI 


1.1  Background 

^  The  Vehicle  Simulation  software  is  the  genesis  of  the  distributed  simulation  concept.  The 
first  devices  to  interact  over  the  SIMNET  networic  were  two  Ml  vehicle  simulators. 
Gradually  the  concept  diversified  to  add  a  greater  variety  of  vehicles,  as  well  as  network 
analysis  tools,  command  and  control  simulators,  and  Semi- Automated  forces.  > 

A  vehicle  simulator  is  composed  of  one  or  more  crewstations.  Each  crewstation  provides 
the  subset  of  the  controls  and  indicators  tiiat  would  be  available  to  that  specific  crew 
member  on  the  actual  vehicle.  For  example,  on  the  Ml  vehicle  simulator  the  driver  is 
provided  with  the  steering  bar,  throttle,  and  brake  controls  necessary  to  drive  the  tank.  A 
critical  element  of  each  crewstation  is  the  out-the-window  view,  or  vision  block,  associated 
with  the  station.  These  vision  blocks  provide  the  crew  member  with  a  three  dimensional 
graphical  representation  of  the  terrain  and  objects  in  the  environment  external  to  the  vehicle. 

The  puipose  of  the  vehicle  simulation  software  is  to  maintain  the  vehicle  specific  model, 
respond  to  crew  inputs,  update  crewstation  outputs,  and  communicate  with  the  network.  ^ 

The  vehicle  specific  model  includes  the  mathematical  model  of  the  drivetrain,  powerplant, 
suspension,  weapon  systems,  and  any  other  internal  systems  necessary  to  compose  the 
vehicle  entity.  Tliese  systems  that  are  modeled  have  their  corresponding  operator  interfaces 
in  the  crewstations.  The  crewstation  outputs  include  the  local  sound  system  and  the 
updates  to  the  Computer  Image  Generator  (CIG),  which  presents  the  three  dimensional 
image  in  the  vision  blocks.  Though  it  may  be  composed  of  several  individual 
crewstations,  the  vehicle  simulation  represents  a  single  entity  on  the  network,  and  interacts 
with  other  network  entities  via  the  network  interface. 

In  this  document,  the  software  for  three  vehicle  simulations  will  be  presented. 

These  vehicles  arc; 

-  the  Ml  Abrams  Tank 

-  the  M2  Bradley  Fighting  Vehicle 

-  the  Stealth  (or  Observation)  Vehicle. 

This  document  is  intended  to  provide  a  "roadmap"  through  the  Ml  and  M2  simulation  and 
Stealth  Vehicle  code.  It  is  divided  into  four  sections.  Section  1  provides  a  high  level 
functional  description  of  the  Vehicles  CSCI.  It  describes  the  interfaces  of  this  CSCI  with 
other  CSCIs  in  the  system,  as  well  as  the  internal  structure  of  the  Vehicles  CSCI. 

Section  2  describes  each  of  the  first  level  CSCs  which  compose  the  Vehicles  CSCI.  Each 
first  level  CSC  is  broken  down  into  its  component  CSCs  and  CSUs  based  on  the 
functionality  of  the  code.  Each  CSU  is  mapped  to  a  library  or  a  file.  For  each  relevant 
procedure,  information  is  provided  about  the  parameters  operated  on,  values  returned, 
errors  returned,  callers  of  the  procedure,  and  routines  called  by  the  procedure. 

Section  2.1  contains  information  about  the  code  that  was  generated  to  interface  with 
external  devices.  Section  2.2  provides  information  about  the  major  functions  of  the  Ml 
simulation.  Section  2.3  provides  information  about  the  major  functions  of  the  M2/M3 
simulation.  Section  2.4  provides  information  about  the  major  functions  of  the  Stealth 
Vehicle  simulation.  Section  2.5  provides  information  about  the  vehicle  simulation  libraries. 
Lastly,  Section  2.6  discusses  tools  and  utilities  that  are  used  throughout  the  simulation. 
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Section  3  describes  the  resources  which  are  utilized  by  the  Vehicles  simulation,  and  Section 
4  contains  the  source  code  listings. 


1.2  External  Interfaces 

The  vehicle  simulation  software  is  executed  on  a  single  processor.  This  processor  is 
referred  to  as  the  Simulation  Host  The  host  communicates  via  several  external  interfaces 
with  other  processors  that  compose  a  portion  of  the  same  vehicle  simulator,  or  another 
simulation  host  The  number  and  type  of  interfaces  depend  on  the  vehicle  being  simulated 
and  the  architecture  of  the  simulator. 

The  external  interfaces  for  the  Ml,  M2  and  Stealth  vehicle  simulators  are; 

-  the  CIG 

-  the  Simulation  Network  (SIMNET). 

These  interfaces  are  depicted  in  figures  1.2-1  and  1.2-2. 

The  simulator  host  tells  the  Computer  Image  Generator  (CIG)  what  to  display,  that  is, 
where  on  tiie  terrain  the  simulated  vehicle  is  loca^.  It  also  tells  the  CIG  the  orientation  of 
the  simulated  vehicle,  the  location  and  orientation  of  the  other  simulated  vehicles,  and 
where  to  display  special  effects  such  as  bomb  blasts  and  smoke.  The  CIG  sends  the 
simulator  host  descriptions  of  the  local  terrain  around  the  simulated  vehicle. 

The  simulator  host  describes  the  current  vehicle  state  to  the  Management  Command  and 
Control  (MCC),  the  other  CSCIs,  and  the  other  simulators.  They,  in  turn,  keep  it 
informed  of  the  state  of  the  entire  exercise.  These  communications  are  carried  out  over 
SIMNET. 

The  communications  schemes  for  the  Ml  and  M2/M3  simulators  and  the  Stealth  Vehicle 
appear  in  Figures  1.2-1  and  1.2-2. 
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Figure  1.2-1  Communications  Scheme  for  M1/M2  Simulators 


Figure  1.2-2:  Communications  Scheme  for  Stealth  Simulation. 

The  vehicles  communicate  with  other  vehicles  and  other  CSCIs  over  SIMNET  using 
Protocol  Data  Units  (PDUs).  Each  vehicle  looks  for  (subscribes  to)  specific  PDUs  sent  out 
by  other  vehicles  and  the  other  CSCIs.  Each  vehicle  also  sends  out  (broadcasts)  PDUs  of 
its  own.  Table  1.2-1  lists  the  PDUs  which  are  of  importance  to  the  vehicles. 
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Table  1.2>1:  PDU  Information. 


PDU 

CSCI 

CSCI 

In 

Protocol 

Transaction 

Protocol  Data 

Recleved 

Sent  To 

Response 

Type 

Type 

Unit 

From 

To 

Activate 

MCC 

Vehicle 

Vehicle 

Simulation 

Transaction 

Request 

needs  to  be 
activated 

Activate 

Vehicle 

MCC 

Activate 

Simulation 

Transaction 

Response 

Request 

Deactivate 

Vehicle 

MCC 

Vehicle 

Simulation 

Transaction  or 

Request 

or 

Vehicle 

or 

MCC 

Vehicle 

needs  to  be 
deactivated 

Datagram 

Vehicle 

Deactivate 

Vehicle 

MCC 

Deactivate 

Simulation 

Transaction 

Response 

Request 

Vehicle 

Vehicle 

Multicast 

Update  or 

Simulation 

Datagram 

Appearance 

Group 

change 

vehicle 

appearance 

Radiate 

Vehicle 

Periodic 

Simulation 

Datagram 

Fire 

Vehicle 

Directed  fire 

Simulation 

Datagram 

Impact 

Vehicle 

Multicast 

Impact  of 

Simulation 

Datagram  or 

Group 

direct  fire  from 
firing  vehicle 

Transaction 

Indirect  Fire 

MCC 

Non-direct  fire 

Simulation 

Datagram 

Collision 

Colliding 

Colliding 

Vehicle 

Simulation 

Transaction  or 

Vehicle 

or 

MCC 

Vehicle 

collision 

Datagram 

Multicast 

Group 

Senrice 

Vehicle 

MCC 

Need  for 

Simulation 

Datagram 

Request 

munitions  or 
repairs 

Resupply  Offer 

MCC 

Vehicle 

Request  for 
service 

Simulation 

Datagram 

Vehicle 

MCC 

Simulation 

Datagram 

Resupply 

Vehicle 

MCC 

Vehicle  no 

Simulation 

Datagram 

Cancel 

or 

longer  meets 

MCC 

Vehicle 

conditions  for 
resupply 

Repair  Request 

Vehicles 

MCC 

Repair 

process 

complete 

Simulation 

Transaction 

Error 

PVD 

Stealth 

Any  Stealth 

Stealth 

Transaction 

Vehicle 

protocol 

command 
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Table  1.2-1:  PDU  Information  (cont.). 


POU 

Protocol  Data 
Unit 

CSCI 

Received 

From 

CSCI 

Sent  To 

In 

Response 

To 

Protocol 

Type 

Transaction 

Type 

Visibility 

PVD 

Stealth 

Vehicle 

Instructs 

Stealth 

Vehicle  to 
change 
exercise  ID's 

Stealth 

Teleport 

PVD 

Stealth 

Vehicle 

Tells  Stealth 
Vehicle 
where  to  qo 

Stealth 

Attach 

PVD 

Stealth 

Vehicle 

Tells  what 
vehicle  to 
attach  to 

Stealth 

Attached 

Stealth 

Vehicle 

PVD 

After 

executing  a 
successful 
attach 
operation 

Stealth 

Mimic 

PVU 

Stealth 

Vehicle 

To  instmct  the 
Stealth 

Vehicle  to 
enter  mimic 
mode 

Stealth 

Appearance 

Stealth 

Vehicle 

PVD 

Once  every 
two  seconds 

Stealth 
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The  Vehicles  communicate  with  the  CIG  througii  the  CIG  to  Simulation  Host  Interface. 
This  communication  is  accomplished  through  Ae  use  of  data  messages.  Table  1.2-2  lists 
the  data  messages  which  are  passed  back  and  forth  between  the  Vehicles  and  the  CIG.  (For 
additional  information,  reference  BBN  Document  #8912  -  BBN  GT 100™  CIG  to 
Simulation  Host  Interface  Manual.) 


Table  1.2-2:  CIG_SIM  Message  Information. 


Data 

Message 

CSCI 

Received 

From 

CSCI 

Sent  To 

Message 

Type 

Comment 

CIG  Control 
Message 

Simulation 

Host 

CIG 

Control  /Error 
Message 

Instructs  CIG  to  switch  from  one 
ready  state  to  another 

DR11  Packet 
Size  Message 

Simulation 

Host 

CIG 

Control  /Error 
Message 

At  initialization  or  run  time  to 
change  the  size  of  incoming 
and  outgoing  DR1 1  packet 
buffers. 

End  Message 

Simulation 

Host 

CIG 

OG 

Simulation 

Host 

Control  /Error 
Message 

Indicates  end  of  the  contents  in 
each  packet  buffer  sent 
between  the  CIG  and 

Simulation  Host. 

CIG 

Simulation 

Host 

Control  /Error 
Messaae 

In  every  packet  buffer. 

2-D  Setup 
Messaae 

Simulation 

Host 

OG 

Configuration 

Messaae 

Sets  up  subsystem’s  2-D 
display  data. 

Create 

Configuration 
Node  Messaae 

Simulation 

Host 

CIG 

Configuration 

Message 

Defines  configuration  node 
tree.  Sent  at  initialization. 

Define  TX 

Mode 

Messaae 

Simulation 

Host 

OG 

Configuration 

Message 

Used  to  set  up  viewport 
switching  information  for  TX 
subsystems. 

Overlay  Setup 
Messaae 

Simulation 

Host 

CIG 

Configuration 

Messaae 

Sets  up  data  required  to  display 
3-D  overlays  for  gun  barrels. 

Serial  Device 
Close 

Messaae 

Simulation 

Host 

OG 

Configuration 

Message 

Used  during  “prepare  for 
simulation”  state  to  close  a 
channel  to  a  subsystem. 

Serial  I/O 

Initialization 

Message 

Simulation 

Host 

CIG 

Configuration 

Message 

Used  during  “prepare  for 
simulation”  state  to  open  a 
channel  to  a  device  for  output 
during  simulation  state. 

Trajectory 

Entry  Transfer 
Message 

Simulation 

Host 

OG 

Configuration 

Message 

Immediately  follows  Trajectory 
Table  Transfer  message; 
specifies  each  entry  in 
trajectory  table. 

Trajectoiy 

Table  Transfer 
Messaae 

Simulation 

Host 

CIG 

Configuration 

Message 

l>>ed  to  load  30  Hz  ballistics 
ttajectory  table  into  CIG  for  use 
durina  simulation. 

Simulation 

Host 

CIG 

Configuration 

Messaae 

Describes  viewport  attributes  to 
CIG. 

1  Rotation 
Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Updates  vehicle  rotation. 
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Table  1.2-2:  CIG_SIM  Message  Information  (cont.)* 


Data 

Message 

CSCI 

Received 

From 

CSCI 

Sent  To 

Message 

Type 

Comment 

3  Rotations 
Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Updates  vehicle  orientation. 

Add  Trajectory 
Table  Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Enhances  the  present 

Trajectory  Table  Transfer 
message. 

AGL  Setup 
Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Triggers  the  CIG  ballistics 
process  into  determining  the 
height  above  ground  and 
returns  this  value  to  the 
simulator  host  each  frame. 

Cancel  Round 
Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Allows  simulator  host  to  cancel 
a  round  that  ballistics  is 
processing. 

Cloud  State 
Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Provides  data  needed  to 
position  the  cloud  models  at 
the  desired  altitude. 

Delete 

Trajectory 

Table  Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Allows  simulation  host  to  delete 
trajectory  tables  it  downloaded 
earlier  so  that  memory  can  be 
recovered  and  used  for  new 
trajectory  tables. 

Gun  Overlay 
Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Updates  gun  barrel  position 
and  gunner's  information. 

HPRXYZS 

Matrix 

Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Sent  each  frame  to  update  the 
-heading,  Pitch,  Roll,  X,  Y,  Z, 
Scale"  matrix  associated  with  a 
configuration  node. 

Obscure 

Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Displays  a  texture  pattern  on 
any  viewport. 

Other  Vehicle 
State  Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Tracks  each  "other"  vehicle 
within  maximum  viewing  range 
of  the  simulator  vehicle.  Sent 
every  frame  for  each  vehicle 
until  it  moves  beyond  the 
maximum  range. 

Pass  On 
Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Provides  the  means  to  send 
data  through  the  CIG  system  to 
a  system  embodied  within  the 
CIG. 

Process 

Round 

Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Enhances  the  Round  Fired 
Message  by  sending  additional 
data  to  the  ballistics  processor 
about  a  round. 

BBN  Systems  and  Technologies 


Vehicles  CSCI 


Table  1.2-2:  CIG_SIM  Message  Information  (cont.). 


Data 

Message 

CSCI 

Received 

From 

CSCI 

Sent  To 

Message 

Type 

Comment 

Request  Laser 
Range 

Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Sent  when  the  simulation  host 
requires  laser  range  information 
for  a  viewport. 

Request  Point 

Information 

Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Finds  terrain  characteristics  at 
any  point  within  the  viewing 
range. 

Rotate  2x1 
Matrix 

Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Updates  vehicle  position. 

Round  Fired 
Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Sends  data  to  a  ballistics 
processor  about  a  round. 

RTS  4x3  Matrix 
Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Updates  vehicle  position  given 
the  precalculated 
transfonnation  matrix. 

Scale  Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Not  currently  in  use. 

Serial  I/O  Write 
Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Accepted  during  simulation 
state  to  write  data  to  a  device. 

Show  Effect 
Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Commands  the  CIG  to  display 
an  effect. 

Static  Vehicle 

Remove 

Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Instructs  CIG  to  rerTx>ve  a 
particular  static  vehicle  from  the 
display. 

Static  Vehicle 
State  Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Places  static  vehicles  and 
obstacles  in  the  sirrxjlation. 

Subsystem 

Mode 

Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Used  by  the  simulation  host  to 
change  subsystem  specific 
parameters. 

Terrain 

Feedback 

Initialization 

Header 

Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Used  to  control  the  way  the  CIG 
builds  the  terrain  feedback 
message. 

Terrain 
Feedback 
Initialization 
Point  Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Sent  after  every  Terrain 
Feedback  Initialization  Header 
Message.  Specifies  the  points 
in  vehicle  coordinates  from 
which  the  terrain  feedback 
information  is  to  be  acguired. 
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Table  1.2-2:  CIG_SIM  Message  Information  (cont.). 


Data 

Message 

CSCI 

Received 

From 

CSCI 

Sent  To 

Message 

Type 

Comment 

Terrain 

Feedback 

State  Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Tells  the  CIG  to  start  and  stop 
gathering  terrain  feedback 
information  for  a  specific 
vehicle,  or  to  change  the 
frequency  of  processing  for 
one's  own  vehicle. 

Terrain 

Feedback 

Vehicle 

Position 

Message 

Simulation 

Host 

CIG 

Simulation 

Support 

Message 

Informs  the  CIG  of  new  position 
and  rotation  of  a  simulated 
vehicle,  other  than  one's  own 
vehicle,  for  which  terrain 
feedback  data  is  being 
collected. 

Trajectory 

Chord 

Messaae 

Simulation 

Host 

CIG 

Simulation 

Support 

Messaae 

Sends  specific  chords  to  the 
ballistics  processor. 

Trajectory 

Entry  Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Enhances  the  Trajectory  Entry 
Transfer  message.  Sent  after 
an  Add  Trajectory  Table 
Message  is  sent. 

Translation 

Message 

Simulation 

Host 

OG 

Simulation 

Support 

Messaae 

Sent  every  frame  to  update  the 
vehicle  x,  y,  z  position. 

View  Flags 
Message 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Switches  viewport  paths  on  or 
off  and  changes  branch  values 
associated  with  the  branch 
nodes. 

View 

Magnification 

Messaae 

Simulation 

Host 

OG 

Simulation 

Support 

Messaae 

Changes  the  field-of-view 
values  specified  in  the 

Viewport  State  Messaae. 

Viewport 

Update 

Messaae 

Simulation 

Host 

OG 

Simulation 

Support 

Message 

Used  to  change  CIG  viewport- 
specific  parameters. 

AGL  Message 

OG 

Simulation 

Host 

Simulation 

Support 

Message 

Returns  the  height  above 
ground  of  one's  own  vehicle 
centroid. 

Hit  Return 
Message 

OG 

Simulation 

Host 

Simulation 

Support 

Message 

Returns  the  ballistics 
intersection  information  if  a 
terrain  polygon  is  struck. 

Laser  Return 
Message 

OG 

Simulation 

Host 

Simulation 

Support 

Message 

Returns  laser  range  information 
for  the  specified  pixel  within  the 
screen  each  frame. 

Local  Terrain 
Message 

OG 

Simulation 

Host 

Simulation 

Support 

Message 

Contains  information  which  the 
simulator  host  uses  to 
determine  the  position  and 
orientation  of  the  simulated 
vehicle  and  to  calculate  the 
dynamics  of  that  vehicle. 
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Table  1.2-2:  CIG_SIM  Message  Information  (cont.). 


Data 

Message 

CSCI 

Received 

From 

CSCI 

Sent  To 

Message 

Type 

Comment 

Local  Terrain 
Place  Message 

OG 

Simulation 

Host 

Simulation 

Support 

Message 

Divides  the  Local  Terrain 
message  into  predefined 
pieces  that  are  transmitted  one 
piece  per  frame. 

Miss  Message 

CIG 

Simulation 

Host 

Simulation 

Support 

Message 

This  message  is  returned  when 
a  round  specified  by  a  Process 
Round  Message  or  Round 

Fired  Message,  or  a  chord 
specified  by  a  Trajectory  Chord 
Message,  does  not  intersect 
with  any  database  element. 

Pass  Back 
Message 

OG 

Simulation 

Host 

Simulation 

Support 

Message 

Returns  information  from  an 
embedded  processor  to  the 
simulation  host.  Applies  only  to 
TX  subsystems. 

Return  Point 

Information 

Message 

OG 

Simulation 

Host 

Simulation 

Support 

Message 

Returns  information  about 
requested  points. 

Terrain 

Feedback 

Header 

Message 

OG 

Simulation 

Host 

Simulation 

Support 

Message 

Sent  as  the  first  message  of  a 
set  of  messages  containing 
terrain  feedback  information  for 
a  specific  vehicle. 

Terrain 

Feedback 

Point  Message 

OG 

Simulation 

Host 

Sent  as  part  of  a  set  of 
messages  containing  terrain 
feedback  information. 

File 

Description 

Message 

CIG 

or 

Simulation 

Host 

Simulation 

Host 

OG 

System 

Support 

Message 

Used  to  identify  files  or 
databases  that  will  be 
transferred. 

File  Status 
Message 

OG 

or 

Simulation 

Host 

Simulation 

Host 

OG 

System 

Support 

Message 

Used  to  acknowledge  that  a 
block  has  been  received,  or  to 
request  re-transmission  of  the 
block. 

File  Transfer 
Message 

OG 

or 

Simulation 

Host 

Simulation 

Host 

OG 

System 

Support 

Message 

Used  to  transfer  files  and 
databases. 

Test  Name 
Message 

Simulation 

Host 

OG 

System 

Support 

Message 

Requests  that  a  test  be  run. 
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1.3  Internal  Structure 

The  vehicle  simulation  software  is  a  real  time  component  that  is  executed  at  a  fixed  rate. 
Each  pass  through  the  real  time  loop  is  referred  to  as  a  frame.  The  frame  event,  the  event 
that  indicates  the  beginning  of  the  frame,  is  controlled  by  the  interface  to  the  CIG.  During  a 
frame  the  vehicle  simulation  receives  inputs  from  the  external  interfaces,  updates  the  vehicle 
nxxiel  accordingly,  and  updates  the  outputs  to  the  external  interfaces. 

In  addition,  the  internal  interfaces  are  checked  and  updated.  The  crewstation  controls  are 
read  and  updated  via  the  Interactive  Device  Controller  (IDC).  The  sound  system  is  also 
updated  to  complete  the  tactile  queues  for  the  crew  members.  During  the  frame,  keyboard 
inputs  are  processed,  primarily  for  debugging  purposes,  and  outputs  are  generated  to  the 
simulator  console  if  appropriate.  The  status  panel  indicators  are  altered  if  a  change  in  the 
maintenance  state  of  the  simulator  occurs. 

A  vehicle  simulation  is  divided  into  six  states: 

-  Start-Up 
-Idle 

-  Simulation  Initialize 

-  Simulation 

-  Simulation  Stop 
-Exit 

During  the  Start-Up  state,  the  mechanizations  that  are  required  to  be  performed  only  once 
when  the  application  is  run  are  performed.  For  example,  communication  devices  are 
opened  to  Ae  external  interfaces,  and  blocks  of  memory  are  allocated  at  this  time.  The 
simulation  transitions  automatic^ly  from  Start-Up  to  Me  state,  where  it  waits  for  activation 
and  the  transition  to  Simulation  Initialize  state. 

At  Simulation  Initialize  state,  those  activities  that  must  be  performed  once  for  each  restart  of 
the  vehicle  are  performed.  For  example,  the  controls  and  indicators  are  placed  in  a  known 
condition  here. 

In  the  Simulation  state,  the  controls  are  active,  and  the  vehicle  models  as  well  as  all  of  the 
external  interfaces  are  updated.  From  this  state  the  simulation  may  transition  to  Simulation 
Stop,  which  transitions  to  Idle  state,  or  Exit,  which  leaves  the  application  altogether. 

The  organization  of  the  Vehicles  CSCI  is  shown  in  Figure  1.3-1. 
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Figure  1.3>1  Structure  of  the  Vehicles  CSCI. 


The  following  six  (6)  first  level  CSC’s  are  associated  with  this  CSCI: 

Device  Interface  Software 
Ml  Vehicle  Simulation  Software 
M2  Device  Simulation  Software 
Stealth  Vehicle  Simulation  Software 
Vehicle  Libraries 
Simulation  Support  Utilities 


1.4  Configuration  and  Configuration  Management 

The  software  components  are  grouped  in  libraries  according  to  either  the  corresponding 
external  interface,  or  the  subsystem  that  is  being  simulated.  These  libraries  are  assembled 
into  a  hierarchy,  with  the  most  generic  components  (those  shared  by  multiple  vehicles)  at 
the  tq),  and  the  most  vehicle  specific  components  at  the  bottom.  This  software  is  written  in 
the  C  Itogramming  Language  and  is  ported  to  several  platforms. 

The  Ml  simulator  program  host  is  an  MC  56QO  MASSCOMP^  computer  based  on  the 
68020  microprocessor.  It  sends  command  messages  to  and  receives  information  from 
other  parts  of  the  simulator  and  system. 

The  M2  simulator  program  host  is  a  BBN™  Butterfly  GPIOOO™,  based  on  the  Motorola 
68020  microprocessor.  It  sends  command  messages  to  and  receives  information  from 
other  parts  of  the  simulator  and  system.  Although  the  Ml  and  M2  simulator  hosts  are 
different  machines,  they  provide  the  same  functionality. 

Two  versions  of  the  Stealth  Vehicle  are  currently  supported.  Stealth  3  and  Stealth  3GT. 

The  Stealth  3  uses  a  BBN  120T  GIG  and  MASSCOMP  56()0  simulator  host  borrowed 
from  an  Ml  simulator.  The  Stealth  3GT  uses  a  BBN  GTlOl™  GIG  and  MVME147  board 
host  computer  for  image  generation  and  host  simulation. 
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1.5  Terminology  and  Documentation 

The  following  documents  provide  additional  information  about  the  vehicle  simulation  and 
hardware: 

BBN  Rqrort  No.  6323  -  SIMNET  Ml  Abrams  Main  Battle  Tank  Simulation;  Software 
Description  and  Documentation  (Revision  1) 

BBN  Report  No.  6892  -  SIMNET  M2/3  Bradley  Fighting  Vehicle  Simulation;  Software 
Description  and  Documentation 
BBN  Report  No.  7102  -  The  SIMNET  Network  and  Protocols 
BBN  Report  No.  7348  -  SIMNET  Stealth  Vehicle  Functional  Specification  and  Operator’s 
Manual 

Top-level  Descriptions  for  SIMNET  Software,  May  1990 
The  SIMNET  Maintenance  Manual 

BBN  Document  No.  8912  -  BBN  GTlOOtm  GIG  to  Simulation  Host  Interface  Manual 


A  glossary  of  terms  and  abbreviations  appears  in  Appendix  D. 

1.6  Miscellaneous 

There  are  header  files  associated  with  each  of  the  libraries  and  vehicle  specific  simulation 
files.  These  files  are  important  for  understanding  the  simulation  code.  They  contain 
external  references  to  routines  that  are  externally  accessible  from  the  libraries.  They  contain 
external  references  to  global  variables  and  contain  definitions  of  data  types  and  constants 
for  use  as  parameters.  These  files  are  listed  in  Appendix  A. 
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2  CSC  DESCRIPTIONS 
2.1  Device  Interface  Software 

Figure  2.1-1  illustrates  the  structure  of  the  Device  Interface  Software  CSC. 


Figure  2.1-1:  Device  Interface  Software  structure. 

The  simulation  host  must  communicate  with  a  number  of  different  devices.  These  devices 
include  the  Computer  Image  Generator  (CIG),  the  SIMNET  local  area  network  (LAN),  the 
sound  system,  the  status  panel,  the  controls,  and  the  host  keyboard  (for  development 
purposes).  The  term  controls  refers  to  the  collection  of  controls,  lights,  switches,  meters, 
etc.  The  Stealth  Vehicle  host  must  communicate  with  many  of  the  above  devices  as  well  as 
widi  die  Spaceball™. 

Software  modules  provide  interfaces  to  each  of  these  devices.  Since  the  Ml,  M2,  and 
Stealth  vehicle  simulations  need  to  communicate  with  this  set  of  devices,  the  interfaces 
incoiporate  a  significant  amount  of  functionality  required  for  vehicle  sirai’lation  in  general, 
allowing  large  amounts  of  software  to  be  shared  by  all  three  applications.  The  individual 
modules  are  described  below. 

The  second  level  CSCs  associated  with  this  CSC  are  as  follows: 

Network  Interface  Software 
QG  Interface  Software 
Sound  Interface  Software 
Controls  Interface  Software 
Status  Panel  Interface  Software 
Keyboard  Interface  Software 
Spaceball™  Interface  Software 
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2.1.1  Network  Interface  Software 

Figure  2.1-2  shows  the  structure  of  the  Network  Interface  Software  CSC. 


Network  Interface 
Software 

5.1.1 


Network 

Device 

Interface 


Association 

Layer 


Host 

Network 

Interface 


5.1. 1.1 


I—  libnetif 

5.1. 1.1.1 


5.1. 1.2 


hlibassoc 

5.1. 1.2.1 


-  Iibp2p 

5. 1.1 .2.2 


5.1. 1.3 


hlibSendNet 
5.1. 1.3.1 


libRcvNet 

5.1.1.3.2 


Figure  2.1<2:  Network  Interface  Software. 

The  SIMNET  LAN  is  accessed  through  a  set  of  software  modules  organized  as  C  archive 
libraries.  These  libraries  provide  a  high  level  interface  to  the  SIMNET  network.  For 
exan^le,  a  function  call  can  be  made  by  the  simulation  host  to  inform  the  outside  world  of 
its  current  status.  All  of  the  internals  of  formatting  the  packet  and  moving  it  onto  the 
network  are  handled  by  the  network  module. 

This  second  level  CSC  is  made  up  of  the  following  third  level  CSCs; 

Network  Device  Interface 
Association  Layer 
Host  Network  Interface 

Note  that  the  "Called  By"  sections  of  the  tables  describing  the  routines  contained  in  these 
CSCs  will  list  only  the  routines  that  call  them  internal  to  &e  module. 
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2.1.1.1  Network  Device  Interface 

A  facility  was  required  for  sending  and  receiving  data  messages  over  SIMNET,  initializing 
and  stepping  the  network  interface,  testing  the  status  of  the  interface,  and  manipulating 
shared  memory  buffers.  This  functionality  is  realized  by  the  CSU  libnetif. 


2.1.1.1.1  libnetif 

(7simnetA«lease/sic/libsrc/libnetif  [libnetif]) 

Libnetif  provides  an  operating  system  and  hardware  platform  independent  interface  to  the 
network.  The  library  interface  is  layered  on  top  of  the  facilities  provided  by  the  operating 
system  and  hardware  platform. 

Libnetif  provides  facilities  for  sending  and  receiving  datagrams,  obtaining  and  zeroing 
network  statistics,  obtaining  the  local  station  address,  manipulating  network  addresses,  and 
specifying  multicast  addresses  for  receipt.  Additionally,  a  set  of  control  functions  is 
available  for  initializing  and  stopping  the  network  interface,  testing  the  status  of  the 
interface,  manipulating  memory  buffers  shared  between  the  application  and  the  interface, 
and  timestamping  packets. 

Reference  Section  2.20.21  in  the  MCC  CSCI  SDD. 


2. 1.1.2  Association  Layer 

The  SIMNET  Association  Layer  provides  network  services  to  send/receive  datagrams,  and 
exactly  once  (xo)  transactions.  It  also  provides  a  subscription  service  to  multicast 
addresses  on  the  network,  allowing  an  individual  application  to  selectively  acceptAeject 
network  traffic  from  different  SIM^T  exercises,  and  different  protocols  within  an 
exercise.  The  CSUs  that  make  up  this  CSC  are  libassoc  and  libp2p. 

2.1.1.2.1  libassoc 

(./simnet/release/src/libsrc/libassoc  [libassoc] ) 

Libassoc  communicates  with  the  network  through  libnetif  to  provide  these  services. 
Reference  Section  2.20.1  in  the  MCC  CSCI  SDD. 
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2. 1.1. 2. 2  libp2p 

(./simnet/release/src/libsrc/libp2p  [iibp2p]) 

Point  to  point  communication  is  accomplished  by  creating  point  to  point  datagrams.  Point 
to  point  datagrams  consist  of  a  Simulation  or  Data  Collection  PDU  with  a  point  to  point 
he^r.  This  library  contains  the  routines  used  to  initialize,  send,  and  receive  the  point  to 
point  datagrams. 


2. 1.1. 2. 2.1  init.c 

(ysimnet/release/src/Iibsrc/libp2pAniLc) 


Includes: 

"assoc.h" 

"address.h" 

"p_num.h" 

Variable  Declarations: 
p2pSimAddress 


2. 1.1. 2. 2. 1.1  PointToPointOpen 


This  routine  contains  the  definitions  needed  to  initialize  the  point  to  point  layer. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

device 

pointer  to  char 

Standard 

def 

pointer  to  char 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

netHandle 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

netHandle 

int 

procedure  was  successful;  it 
will  be  used  as  a  handle  to  all 
subseouent  p2p  or  assoc  calls 

-1 

int 

procedure  failed 

I  Calls  I 

Function 

Where  Described 

AssocOoen 

See  MCC  CSCI  Section  2.20.1.5.1 

AssocSubscribe 

See  MCC  CSCI  Section  2.20.1.1.1 

AssocGetSimAddress 

See  MCC  CSCI  Section  2.20.1.9.1 

Table  2.1>1:  PointToPointOpen  Information. 
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2. 1.1. 2. 2. 2  p2p.h 

(ysimnel/release/src/libsic/libp2p/p2p.h) 

This  file  contains  all  definitions  needed  by  external  modules  to  use  the  point  to  point  layer 
library. 

Procedure  Declarations; 

PointToPointOpen 

PointToPointReceivePDU 

PointToPointSendPDU 

2. 1.1. 2. 2. 3  p2p_local.c 

(ysimnet^lease/src/libsrc/libp2p^2pJocal.c) 

This  file  contains  all  definitions  needed  locally  to  use  the  point  to  point  layer  library. 

IDefines; 

DATACXDPY 

External  Declarations: 
p2pSiniAddress 
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2. 1.1. 2. 2. 4  receive.c 

(./simnet/release/src/libsrc/libp2pAeceive.c) 

Includes: 

"assoc.h" 

"p_p2p.h" 

"p_num.h" 

"p2p_local.h" 

2. 1.1. 2.2.4. 1  PointToPointRecei  vePDU 

This  routine  contains  all  definitions  needed  to  receive  packets  from  the  SIMNET  network 
through  the  point  to  point  layer  library.  When  a  point  to  point  datagram  is  received,  its 
point  to  point  header  is  removed,  leaving  the  underlying  simulation  PDU. 


Parameter 


handle 


data 


lenath 


protocol 


r- 


rimitive 


orlainator 


transID 


resDondent 


Parameters 


DOinter  to  oointer  to  char 


I  DOinter  to  Iona  int 


inter  to  MulticastGrouolD 


pointer  to 

AssociationUserProtocol 


inter  to  Iona  int 


inter  to  SimuiationAddress 


irs 

\n 

irs 


Where  Typedef  Declared 


Standard 


Standard 


Standard 


assoc.h 


p_assoc.h 


Standard 


address.h 


inter  to  Transactionidentifier  address.h 


inter  to  SimuiationAddress  address.h 


assocRetval 


Internal  Variables 


e 


inter  to  PointToPointPDU 


Where  Typedef  Declared 


Standard 


Return  Value 


assocRetVal 


Return  Values 


Meanin 


The  return  value  from  the  call 
to  AssocReceive; 
if  equal  to  0:  packet  received 
if  equal  to  1 :  no  packet 


the  packet  was  received 


no  packet  was  received 


Function 


AssocReceivePDU 


ASSOC  ADDRESS  EQUAL 


AssocCurrentIvSubscribed 


Calls 


Where  Described 


See  MCC  CSCI  Section  2.20.1.6.1 


assoc.h 


See  MCC  CSCI  Section  2.20.1.1.3 


Table  2.1>2:  PointToPointReceivePDU  Information. 
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2.1. 1.2. 2. 5  send.c 

(ysimnet/release/src/libsrc/libp2p/send.c) 


Includes: 

"network.h" 

"p_assoc.h" 

"p_p2p.h" 

"p_num.h" 

"p_size.h" 

"assoc.h" 

"p2p_IocaI.h" 

Declarations: 

bufI(MAX_DATA_SIZE_8023  /  sizeof(AssociationDataUnit))  +  1] 

2. 1.1. 2. 2. 5.1  PointToPointSendPDU 

This  routine  contains  all  definitions  needed  for  sending  point  to  point  datagrams. 

Simulation  PDUs  are  given  a  point  to  point  header  and  sent  through  the  point  to  point 

communictions  layer. 


Parameters  1 

Parameter 

Where  Tvpedef  Declared 

handle 

int 

Standard 

data 

pointer  to  char 

Standard 

lenath 

Iona  int 

Standard 

arouD 

MulticastGroupIO 

p  assoc.h 

protocol 

AssociationUserProtocol 

p  assoc.h 

destination 

pointer  to  SimulationAddress 

address.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

2 

pointer  to  PointToPointPDU 

P  p2p2.h 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

0 

int 

procedure  was  successful 

-1 

int 

procedure  failed 

I  Calls  I 

Function 

Where  Described 

DATACOPY 

p2p  local.h  (macro  definition) 

AssocSendDataaram 

See  MCC  CSCI  SDD  Section  2.20.1.2.1 

PRO  P2P  PDU  SIZE 

p  size.h  (macro  definition) 

Table  2.1-3:  PointToPointSendPDU  Information 
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2.1.1.3  Host  Network  Interface 

Two  archive  libraries,  libSendNet  and  libRcvNet,  provide  the  host  interface  to  libassoc. 
libSendNet  provides  routines  for  sending  various  t^s  of  SIMNET  packets,  while 
libRcvNet  provides  routines  for  receiving  them. 

When  the  simulation  host  is  ready  to  read  a  packet  from  the  network,  it  calls  the  function 
process_a_packet(),  which  can  be  found  in  "proc_a_pkt.c".  process_a_packet() 
requests  a  ^ket  from  the  Association  Layer.  If  the  request  is  successful,  the  function 
decodes  the  packet,  determining  its  protocol  and  type,  and  then  calls  the  appropriate 
function  to  process  that  type  of  packet.  These  packet-specific  functions  m^  up  the 
remainder  of  libRcvNet. 

The  simulation  host  sends  a  packet  onto  the  network  by  calling  a  packet-specific  routine  in 
libSendNet,  and  providing  it  with  whatever  information  is  necessary.  These  routines  then 
use  the  Association  Layer  services  to  send  the  packet  as  either  a  datagram  or  transaction,  as 
appropriate.  The  functionality  of  this  CSC  is  raized  by  the  following  CSUs: 

libSendNet 

libRcvNet 


2.1.1.3.1  libSendNet 

(./simnet/release/src/vehicle/libsrc/libSendNet  [libSendNet]) 
LibSendNet  provides  routines  for  sending  various  types  of  SIMNET  packets. 

2.1. 1.3. 1.1  act^rsp.c 

(7sininetAelease/src/vehicle/libsrc/libSendNet/act_rsp.c) 


Includes: 

"send_loc.h" 

"pro_sim.h" 

"pro_size.h" 

"pro_num.h" 

"pro_assoc.h" 

"net_stats.h" 

"veh_app_loc.h" 
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2. 1.1.3. 1.1.1  send_activate_response 

This  routine  sends  an  activate  transaction  response  PDU  as  an  ac  knowledgement  of  receipt 
of  an  activate  PDU.  Parameters  are  represented  as  follows: 
originator  -  the  simulation  address  of  the  originator 
tid  -  the  transaction  identifier 


Parameter 


inator 


tid 


Parameters 


Where  Typedef  Declared 


inter  to  SimulationAddress  address.h 


Transactionldentifier  address.h 


irs 


Variable 


irn«!«Ti 


Internal  Variables 


SimulationPDU 


register  pointer  to 
Activate  Response  Variant 


Where  Typedef  Declared 


sim.h 


p_sim.h 


l|7 


Function 


veh  spec  activate  time 


fill  simHdr 


AssocSendResponse 


network  get  net  handle 


PRO  SIM  ACTIVATE  RSP  SIZE 


NOTE  SENT 


Calis 


Where  Described 


Section  2.1.1.3.1.42.1 


See  MCC  CSCI  Section  2.20.1.4.2 


Section  2.1.1.3.2.12.1 


size.h  (macro  dfinition 


\n 


Table  2.1-4:  send_activate_response  Information. 

2.1.1.3.1.2  activ_params.c 

(./sin5iet/release/src/vehicle/libsrc/libSendNet/activ_params.c) 

This  file  contains  a  stub  for  vehicles  that  do  not  use  any  of  the  vehicle  specific  activation 
parameters. 

2.1.1.3.1.3  activate.c 

(./simnetAelease/src/vehicle/libsrc/libSendNet/activate.c) 

This  file  is  not  implemented  in  the  Version  6.6  release. 
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2.1.1.3.1.4  appearance.c 

(7simnet/release/src/vehicle/libsrc/libSendNet/appearance.c) 

The  libSendNet  library  keeps  track  of  a  formatted  vehicle  appearance  packet  (VAP),  or 
Vehicle  Appearance  PDU,  for  a  simulated  vehicle.  Once  the  VAP  is  initially  set  up,  large 
portions  remain  constant  from  tick  to  tick  (i.e.,  exerciselD,  veluclelD,  etc.).  Only  cenain 
fields  will  change  during  a  frame  (i.e.,  appearance,  position,  etc.).  This  file  formats  the 
dynamic  parts  of  the  vehicle  ^pearance  packet. 

Includes: 

"send_loc.h" 

"sim_style.h" 

"pro_sim.h" 

"pro_stlth.h" 

"veh_type.h" 

"net_network.h" 

"Ubutil.h" 

"libkin.h" 

"UbhuU.h" 

"libmatrix.h" 

Declarations: 

veh_should_be_scaled 

scale_mat[3][3] 

format_app_debug 

2. 1.1.3. 1.4.1  format_vehicle_appearance 

This  routine  is  called  ftora  net_xinit()  to  format  a  vehicle  appearance  packet  All  of  the 
fields  which  remain  constant  during  an  exercise  (exerciselD,  vehiclelD,  alignment,  etc.) 
should  have  been  set  up  in  network_use_activationO  so  that  this  routine  only  needs  to 
fill  in  dynamic  information  like  appe^ance  and  position.  Note  that  it  calls 
fill_vehicle_spec_appearance()  to  fill  in  vehicle-specific  information. 
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1  Parameters  I 

1  Parameter 

Where  Typedef  Declared 

m _ _ _ 

pointer  to  SimulationPDU 

p  sim.h 

1  Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

vap 

register  pointer  to 
VehicleAppearanceVariant 

p_sim.h 

Calls 

Function 

Where  Described 

d2f  mat  COPY 

Section  2.6.2. 1.1 

kinematics  aet  h  to  w 

Section  2.5.8.2.2 

vec  copy 

Section  2.6.2.59.1 

kinematics  aet  o  to  h 

Section  2.5.8.2.4 

fitter  set  location 

Section  2.5.14 

d2f  vec  copy 

Section  2.6.2.2.1 

kinematics  aet  velocitv 

Section  2.5.8.2.6 

enaine  aet  speed 

Section  2.2.6.2.2.11 

net  current  time 

See  MCC  CSCI  SDD  Section  2.20.2.8.3 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

fill_vehicle_spec_appearance 

Section  2.2.7.1 

Section  2.3.7.1 

Section  2.4. 6.1 

Table  2.1-5:  forniat_vehicIe_appearance  Information 
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2. 1.1.3. 1.4.2  format_stealth_appea ranee 


This  routine  formats  the  dynamic  portions  of  the  stealth  appearance  PDU,  in  the  same 
manner  as  the  routine  format_vehicle_appearance(). 


1  Parameters  I 

1  Parameter 

Type 

Where  Tvpedef  Declared 

LfiW _ _ _ 

pointer  to  StealthPDU 

p  stith.h 

1  Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

sap 

register  pointer  to 
StealthAppearanceVariant 

p_stlth.h 

id 

pointer  to  VehiclelD 

basic,  h 

Calls 

Function 

Where  Described 

d2f  mat  coDV 

Section  2.6.2. i.l 

kinematics  aet  h  to  w 

Section  2.5.8.2.2 

network  aet  vehicle  id 

Section  2.1.1.3.1.22.1 

veh  aet  force 

Section  2.6.10.6.3 

vec  copy 

Section  2.3.2.59.1 

kinematics  aet  o  to  h 

Section  2.5.8.2.4 

fitter  set  location 

Section  2.5.14 

d2f  vec  copy 

Section  2.6.2.2.1 

kinematics  aet  velocity 

Section  2.5.8.2.6 

net  current  time 

See  MCC  CSCI  Section  2.20.2.8.3 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

filLvehicle_spec_appearance 

Section  2.2.7.1 

Section  2. 3.7.1 

Section  2.4.6. 1 

Table  2.1>6:  forniat_stealth_appearance  Information. 
2.1.1.3.1.5  citv_instr.c 

(./simnet/release/src/vehicle/libsrc/libSendNet/citvJnstr.c) 


Code  in  this  file  is  not  compiled  in  the  Version  6.6  release. 
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2.1.1.3.1.6  citv_orient.c 

(7simnetA«lease/src/vehicle/libsrc/libSendNet/citv_orient.c) 

Code  in  this  file  is  not  compiled  in  the  Version  6.6  release. 

2.1.1.3.1.7  coll_rsp.c 

(ysimnetAelease/src/vehicle/libsrc/libSendNet/coll_rsp.c) 


Includes: 

"sendjoc.h" 

"pro_sim.h" 

"pro_size.h" 

"pro_num.h" 

"pro_assoc.h" 

"veh_app_loc.h" 

2. 1.1.3. 1.7.1  net  work_send_collision_response 


This  routine  sends  a  transaction  response  to  a  Collision  PDU. 


i  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

oriainator 

pointer  to  SimulationAddress 

address,  h 

tid 

Transact  ionidentifier 

address.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

pdu 

SimulationPDU 

p  sim.h 

Calls 

Function 

Where  Described 

network  fill  hdr  send  sim  rsp 

Section  2.1.1.3.1.46.1 

Table  2.1-7:  network_send_collision_response  Information. 
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2.1.1.3.1.8  collision.c 

(ysimnetA'elease/src/vehicle/libsrc/libSendNet/collision.c) 


Includes: 

"sendjoc.h" 

"pro_sim.h" 

"pro_size.h" 

"veh_app_loc.h" 

2. 1.1. 3. 1.8.1  net  work_sen  d_outta_niy_way_nif 

This  routine  sends  a  Collision  PDU  as  a  transaction  request  when  the  invoking  process 
detects  a  collision  between  the  vehicle  and  anodier  vehicle. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

eventID 

EventID 

basic.h 

the  auv  i  hit 

Dointer  to  VehiclelD 

basic.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

Ddu 

SimulationPDU 

p.sim.h 

pkt 

register  pointer  to 
CollisionVariant 

p_sim.h 

1  Calls  1 

Function 

Where  Described 

network  fill  hdr  send  sim  trans 

Section  2.1.1.3.1.47,1 

PRO  SIM  COLLISION  SIZE 

p  size.h 

Table  2.1-8:  network_send_outta_my_way_nif  Information. 
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2.1.1.3.1.9  deact_rsp.c 

(ysimnetAclease/src/vehicle/libsrc/libSendNet/deact_rsp.c) 


Includes: 

"sendjoc.h" 

"pro_sim.h" 

"pro-Size.h" 

"pro_num.h" 

"pro_assoc.h" 

"veh_app_loc.h" 

2. 1.1. 3. 1.9.1  network_send_deacti  vate_response 


This  routine  sends  a  transaction  response  to  a  Deactivate  PDU. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

oriainator 

DOinter  to  SimulattonAddress 

address.h 

tid 

T  ransactionidentifier 

address.h 

1  Internal  Variables  1 

1  Variable 

Type 

Where  Typedef  Declared 

SimulationPDU 

p  sim.h 

r 

register  pointer  to 
DeactivateResponseVariant 

p_sim.h 

1  Calls  1 

Function 

Where  Described 

network  fill  hdr  send  sim  rso 

Section  2.1.1.3.1.46.1 

PRO  SIM  DEACTIVATE  RSP  SIZE 

p  size.h 

Table  2.1>9:  network_send_deactivate_response  Information. 
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2.1.1.3.1.10  deactivate.c 

(./simnet/release/src/vehicle/libsrc/libSendNet/deactivate.c) 


Includes; 

”sendJoc.h" 

"pro_sim.h" 

"pro_size.h" 

"veh_app_loc.h" 

2.1.1.3.1.10.1  send_deactivate_pkt 

This  routine  sends  a  Deactivate  Request  PDU  through  the  datagram  service,  in  order  to 
withdraw  a  vehicle  from  the  exercise.  Other  vehicles  receiving  the  Deactivate  Request  PDU 
will  cease  to  dead  reckon  and  display  the  vehicle. 


1  Parameters  1 

1  Parameter 

Where  Tvpedef  Declared 

[reason 

DeactivateReason 

P.sim.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

Ddu 

SimuiationPOU 

p  sim.h 

pkt 

pointer  to 

DeactivateRequestVarlant 

p_sim.h 

1  Calls  1 

Function 

Where  Described 

network  fill  hdr  send  sim  pkt 

Section  2.1.1.3.1.42.5 

PRO  SIM  DEACTIVATE  REQ  SIZE 

p  size.h 

Table  2.1«10:  send_deactivate_pkt  Information. 
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2.1.1.3.1.11  death_status.c 

(./simne^lease/sic/vehicle/libsrc/libSendNet/death_status.c) 

The  values  of  the  Vehicle  Appearance  PDU's  appearance  bit-field  describe  various  effects 
to  the  vehicle's  basic  appearance.  This  file  contains  routines  to  set  these  bits  before 
sending  of  the  Vehicle  Appearance  PDU. 

Includes: 

"sendjoc.h" 

"veh_appear.h" 


2.1.1.3.1.11.1  network_set_death_status 

This  routine  sets  the  VAP  appearance  bit-field  describing  the  vehicle's  death  status  (i.e., 
whether  the  vehicle  is  destroyed). 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

we  are  dead 

int 

Standard 

Table  2.1*11:  network  set  death  status  Information. 


2.1.1.3.1.11.2  net  work_set_smoking_status 


This  routine  sets  the  VAP  appearance  bit-field  describing  the  vehicle's  smoking  status  (i.e., 
whether  a  plume  of  smoke  is  rising  from  the  vehicle). 


i  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

new  smoke 

int 

Standard 

Table  2.1-12:  network_set_smoking_status  Information. 
2.1.1.3.1.11.3  network_set_burning_status 

This  routine  sets  the  VAP  appearance  bit-field  describing  the  vehicle's  burning  status  (i.e., 
whether  flames  are  coming  from  the  vehicle). 


1  Parameters  1 

1  Parameter 

Type 

Where  Tvpedef  Declared 

Inew  bum 

int 

Standard 

Table  2.1-13:  network_set_burning_status  Information. 
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2.1.1.3.1.11.4  net  work_set_commo_kill 

This  routine  sets  the  VAP  appearance  bit-field  describing  whether  the  vehicle's 
communications  appear  to  be  disabled. 


1  Parameters  1 

Parameter 

Tvne 

Where  Tvpedef  Declared 

kill  status 

int 

Standard 

Table  2.1-14:  network_set_commo_kill  Information. 
2.1.1.3.1.11.5  network_set_mobility_kill 

This  routine  sets  the  VAP  appearance  bit-field  describing  whether  the  vehicle's  mobility 
appears  to  be  disabled. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

kill  status 

int 

Standard 

Table  2.1-15:  network_set_mobility_kill  Information. 
2.1.1.3.1.11.6  net  work_set_firepo  wer_kill 

This  routine  sets  the  VAP  appearance  bit-field  describing  whether  the  vehicle's  firepower 
capability  appears  to  be  disabled. 


i  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

kill  status 

int 

Standard 

Table  2.1-16:  network_set_firepower_kill  Information. 
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2.1.1.3.1.12  dust_status.c 

(ysimnet/release/src/vehicle/libsrc/IibSendNet/dust_status.c) 


Includes: 

"send_loc.h" 

"veh_appear.h" 

2.1.1.3.1.12.1  network  set  dust  cloud 


This  routine  sets  a  ground  vehicle's  VAP  appearance  bit-field  indicating  the  appearance  of  a 
trailing  dust  cloud,  and  describing  its  size. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

new  cloud 

int 

Standard 

Table  2.1-17:  network  set  dust  cloud  Information. 


2.1.1.3.1.13  event_flag.c 

(./simnet/release/sic/vehicle/libsrcAibSendNet/event_flag.c) 


Includes: 

"stdio.h" 

"varargs.h" 

"sendjoc.h" 

"veh_app_loc.h" 

"pro_assoc.h" 

"pro_data.h" 

"pro_size.h" 
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2.1.1.3.1.13.1  network_send_event_flag 

This  routine  sends  an  Event  Flag  PDU.  The  event  flag  (or  event  ID)  is  used  by  the  Data 
Collection  system  to  match  up  actions  and  events.  For  example,  the  event  of  a  gun  firing 
involves  performing  several  actions,  such  as  making  sounds  and  showing  effects  (i.e., 
muzzle  flash,  impact,  and  burning  and  smoking  of  an  impacted  vehicle).  This  routine  uses 
the  Standard  C  VARARG  capability  for  handling  variable  argument  lists. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

va_alist 

va_dcl 

Standard 

(variable  argument  list 
declaration) 

1  Internal  Variables  1 

■  Variable 

Where  Tvpedef  Declared 

int 

Standard 

fmt 

pointer  to  char 

Standard 

ap 

va  list 

buf[maxNetworkPDUSize  / 
sizeofdona)! 

long 

Standard 

pdu 

pointer  to  DataCollectionPDU 

p  data.h 

pkt 

register  pointer  to 
EventFlaoVariant 

p_data.h 

text 

pointer  to  char 

Standard 

pointer  to  AssociationPDU 

p  assoc,  h 

max  size 

int 

Standard 

but  size 

int 

Standard 

mallocO 

extern  pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

PRO  ASSOC  DATAGRAM  HDR  SIZE 

p  size.h 

PRO  DATA  EVENT  FLAG  SIZE 

p  size.h 

format  decoder 

Section  2.6.4.15.3 

network  fill  hdr  send  dc  pkt 

Section  2.1.1.3.1.42.6 

PRO  DATA  EVENT  FLAG  SIZE 

p  size.h 

Table  2.1>18:  network_send_event_flag  Information. 
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2.1.1.3.1.14  ex_status.c 

(7simnet/release/src/vehicle/libsrc/libSendNet/ex_status.c) 

Includes: 

"sys/types.h" 

"sys/timeb.h" 

"sendjoc.h" 

"veh_app_loc.h" 

"pio_data.h" 

"pro_assoc.h" 

"pro_size.h" 

"pro_num.h" 

"net_stats.h" 

2.1.1.3.1.14.1  send_exercise_status_pkt 

This  routine  sends  an  Exercise  Status  PDU  using  the  datagram  service.  Normally,  this 
routine  will  be  used  to  provide  information  for  restarting  a  simulator  after  an  equipment 
failure  or  for  restoring  an  exercise  to  earlier  conditions. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

exercise 

ExerciselD 

basic.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

pdu 

DataCollectionPDU 

p  data.h 

pkt 

register  pointer  to 
ExerciseStatusVariant 

p_data.h 

curr  time 

struct  timeb 

1  Calls  1 

Function 

Where  Described 

timers  elapsed  milliseconds 

Section  2.6.3.10.1 

AssocSendDataaram 

See  MCC  CSCI  Section  2.20.1.2.1 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

PRO  DATA  EXERCISE  STATUS  SIZE 

p  size.h 

NOTE  SENT 

Table  2.1-19:  send_exercise_status_pkt  Information. 
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2.1.1.3.1.14.2  send_exercise_status_trans 

This  routine  sends  an  Exercise  Status  PDU  using  the  transaction  service.  Normally,  this 
routine  will  be  used  to  provide  information  in  response  to  a  query. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

oriainator 

pointer  to  SimulationAddress 

address.h 

tid 

Transact  ionidentifier 

address.h 

exercise 

ExerciselD 

basic,  h 

1  Internal  Variables  1 

Variable 

Type 

Where  Tyoedef  Declared 

Ddu 

DataCollectionPDU 

p  data.h 

pkt 

register  pointer  to 
ExerciseStatusVariant 

p_data.h 

current  time 

stnjct  timeb 

1  Calls  1 

Function 

Where  Described 

timers  eiaosed  milliseconds 

Section  2.6.3.10.1 

AssocSendT  ransact 

See  MCC  CSCI  Section  2.20.1.4.1 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

PRO  DATA  EXERCISE  STATUS  SIZE 

D  size.h 

NOTE  SENT 

Table  2.1-20:  send_exercise_status_trans  Information. 

2.1.1.3.1.15  fuState.c 

(./simnetAclease/src/vehicle/libsrc/libSendNet/fuState.c) 

Code  in  this  file  is  not  compiled  in  the  Version  6.6  release. 

2.1.1.3.1.16  get_exer_id.c 

(ysirnhei^lease/src/vehicle/libsrc/libSendNet/get_exer_id.c) 


Includes: 

"send_loc.h" 

"veh_app_loc.h" 

2.1.1.3.1.16.1  net  wor  k_get_exercise_i  d 

This  routine  returns  the  exercise  ID  field  from  the  Vehicle  Appearance  PDU  which  is 
maintained  by  libSendNet  This  routine  is  generally  used  as  a  utility  by  other  modules  in 
the  vehicle  code  that  need  to  access  information  in  ^e  VAP. 


1  Return  Values  1 

Return  Value 

Meaning 

app _pkt->exercise 

ExerciselD 

the  exercise  ID  field  of  the 

VAP 

Table  2.1-21:  network_get_exercise_id  Information. 
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2.1.1.3.1.17  get_force.c 

(ysiinhet^lease/src/vehicle/libsrc/libSendNet/get_force.c) 


Includes: 

"send_loc.h" 

"veh_app_loc.h" 

2.1.1.3.1.17.1  net  work_get_vehicle_force 

This  TCHitine  returns  the  vehicle  force  ID  Beld  firom  the  Vehicle  Appearance  PDU  which  is 
maintained  by  libSentU^et  This  routine  is  generally  used  as  a  utility  by  other  modules  in 
die  vehicle  code  that  need  to  access  information  in  ^e  VAP. 


1  Return  Values  1 

Return  Value 

Meanina 

appj3kt->variant.appearance. 

force 

ForcelD 

the  force  ID  field  of  the  VAP 

Table  2.1>22:  network_get_vehicle_force  Information. 

2.1.1.3.1.18  get^guises.c 

(ysimneVrelease/src/vehicle/libsrc/libSendNet/get_guises.c) 


Includes: 

"pro  sim.h" 

"sendjoc.h" 

"veh_app_loc.h" 

2.1.1.3.1.18.1  network_get_vehicIe_guises 

This  routine  returns  the  vehicle  guises  field  finom  the  Vehicle  Appearance  PDU  which  is 
maintained  by  libSendNet  This  routine  is  generally  used  as  a  utility  by  other  modules  in 
the  vehicle  code  that  need  to  access  information  in  Ae  VAP. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

&app _pkt-> 

variant.aooearance.auises 

pointer  to  VehicleGuises 

vehicle  guise  field 

Table  2.1-23:  network_get_vehicle_guises  Information. 
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2.1.1.3.1.19  get_siin_type.c 

(7siinhet/rdease/src/vehicle/libsrc/libSendNet/get_sim_type.c) 


Includes: 

"sendjoc.h" 

"veh_app_loc.h" 

2.1.1.3.1.19.1  network_get_simulator_ty  pe 

This  routine  returns  the  simulation  type  field  (Ml  simulator,  M2  simulator,  etc.)  from  the 
Vehicle  Appearance  PDU  which  is  maintained  by  libSendNet.  This  routine  is  generally 
used  as  a  utility  by  other  modules  in  the  vehicle  code  that  need  to  access  information  in  the 
VAP. 


1  Return  Values  1 

Return  Value 

Meanina 

my  simulator  type 

SimulatorType 

type  of  my  simulator. 

Table  2.1-24:  network_get_siinulator_type  Information. 

2.1.1.3.1.20  get_unit.c 

(7siinnet/release/src/vehicle/libsrc/libSendNet/get_unit.c) 


Includes; 

"sendjoc.h" 

"veh_appJoc.h" 

2.1.1.3.1.20.1  network_get_veh  icle_unit 

This  routine  returns  the  vehicle's  organizational  unit  field  from  the  Vehicle  Appearance 
PDU  which  is  maintained  by  libSendNet  This  routine  is  generally  used  as  a  utility  by 
other  modules  in  the  vehicle  code  that  need  to  access  information  in  the  VAP. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

&init  pkt->unit 

pointer  to  OrpanizationalUnit 

the  unit  field  of  the  VAP 

Table  2.1-25:  network_get_vehicle_unit  Information. 
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2.1.1.3.1.21  get_veh  app.c 

(7sirnhet/r^eas^src/vehicle/libsrc/libSendNet/get_veh_app.c) 

Includes: 

"pro  ^.h" 

"send_loc.h" 

"veh_app_loc.h" 

2.1.1.3.1.21.1  network_get_vehicle_appearance 

This  routine  returns  the  vehicle  i^pearance  field  from  the  Vehicle  Appearance  PDU  which 
is  maintained  by  libSendNet  This  routine  is  generally  used  as  a  utility  by  other  modules  in 
the  vehicle  code  that  need  to  access  information  in  the  VAP. 


1  Return  Values  1 

Return  Value 

Tvoe 

Meaning 

app_pkt->variant.appearance. 

aoDearance 

unsigned  long 

the  appearance  field  of  the 

VAP 

Table  2.1-26:  network_get_vehicle_appearance  Information. 


2.1.1.3.1.22  get_veh  id.c 

(7simnetA^ease/src/vehicle/libsrc/libSendNet/get_veh_id.c) 

Includes: 

"sendjoc.h" 

"veh_app_loc.h" 

2.1.1.3.1.22.1  net  work_get_vehicle_id 

This  routine  returns  the  vehicle  ID  field  from  the  Vehicle  Appearance  PDU  which  is 
maintained  by  libSendNet  This  routine  is  generally  used  as  a  utility  by  other  modules  in 
the  vehicle  code  that  need  to  access  information  in  the  VAP. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

&app_pkt->variant. 

aopearance.vehiclelD 

pointer  to  VehiclelD 

basic.h 

Table  2.1-27:  network_get_vehicle_id  Information. 
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2.1.1.3.1.23  get_veh  type.c 

(7sinihet/r^ease/sic/vehicle/libsrc/libSendNel/get_veh_type.c) 


Includes: 

"sendjoc.h" 

"veh_app_loc.h" 

2.1.1.3.1.23.1  net  work_get_vehlcIe__type 

This  routine  returns  the  vehicle  type  field  from  the  Vehicle  Appearance  PDU  which  is 
maintained  by  libSendNet  This  routine  is  generally  used  as  a  utility  by  other  modules  in 
the  vehicle  code  that  need  to  access  information  in  VAP. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

init  pkt->status.vehicleTYpe 

ObiectTvpe 

vehicle  type  field 

Table  2.1-28:  network_get_vehicle_type  Information. 


2.1.1.3.1.24  get_xmt  fail.c 

(7simhet/reTease/src/vehicle/libsrc/libSendNet/get_xmt_fail.c) 


Includes: 

"send_loc.h" 


2.1.1.3.1.24.1  net_xmt_failed 

This  routine  returns  the  value  of  the  netxmi  Jailed  flag.  It  is  used  to  determine  whether 
regularly  transmitted  packets  (i.e.,  appearance,  equipment  status,  and  simulation  status 
packets)  are  actually  Ireing  sent. 


1  Return  Values  1 

Return  Value 

Meanina 

netxmtjailed 

BOOLEAN 

if  TRUE,  the  network  transmit 
failed; 

if  FALSE,  the  network  transmit 
was  successful 

Table  2.1-29:  net  xmt  failed  Information. 
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2.1.1.3.1.25  gnd_impact.c 

(7simnet/rclease/src/vehicle/libsrcAibSendNet/gnd_impact.c) 

Includes: 

"sendjoc.h" 

"pro_sim.h" 

"pio_size.h" 

"mun_type.h" 

"sinuammo.h" 

"veh_app_loc.h" 

"Ubmap.h" 

"basic.h" 

Declarations: 

null_vehicleID 

null_vehicle_coords 

2.1.1.3.1.25.1  network_send_ground_iinpact 


This  routine  sends  an  Impact  PDU  for  a  ground  impact 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

eventID 

EventID 

basic.h 

ammo  type 

int 

Standard 

detonator  tvoe 

ObiectType 

p  sim.h 

quantity 

unsigned  short 

Standard 

rate 

unsigned  short 

Standard 

location 

pointer  to  WorldCoordinates 

basic.h 

double 

Standard 

1  internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

Ddu 

SimulationPOU 

p  sim.h 

pkt 

register  pointer  to 

ImpactVariant 

p_sim.h 

1  Calls  1 

Function 

Where  Described 

map  qet  network  type  from  ammo  entry 

Section  2.6.11.2.3 

vec  copy 

Section  2.6.2.59.1 

fvec  copy 

Section  2.6.2.26.1 

network  fill  hdr  send  sim  pkt 

Section  2.1.1.3.1.42.5 

PRO  SIM  IMPACT  SIZE 

p  size.h 

Table  2.1*30:  network_send_ground_impact  Information. 
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2.1.1.3.1.26  iinp_rsp.c 

(7siinnet/release/src/vehicle/libsrc/libSendNet^mp_rsp.c) 


Includes: 

"send_loc.h" 

"pro_sim.h" 

"pro_size.h" 

"pro_num.h" 

"pro_assoc.h" 

"veh_app_loc.h" 

2.1.1.3.1.26.1  network_8end_iinpact_response 

This  routine  sends  a  transaction  response  to  an  Impact  PDU. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

oriQinator 

pointer  to  SimulationAddress 

address,  h 

tid 

T  ransactionidentifier 

address.h 

1  internal  Variables  1 

1  Variable 

Where  Typedef  Declared 

Ipdu _ 

SimulationPDU 

P.  sim.h 

1  Calls  1 

Function 

Where  Described 

network  fill  hdr  send.sim  rsp 

Section  2.1.1.3.1.46.1 

Table  2.1-31:  network_sendJmpact_response  Information. 


2.1.1.3.1.27  laser_detect.c 

(./simnet/release/src/vehicle/libsrc/libSendNet/laser_detect.c) 

Code  in  this  file  is  not  compiled  in  the  Version  6.6  release. 

2.1.1.3.1.28  Iaser_fire.c 

(./simn5/release/src/vehicle/libsrc/libSendNet/laser_fire.c) 

Code  in  this  Ble  is  not  compiled  in  the  Version  6.6  release. 
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2.1.1.3.1.29  laser_range.c 

(7simnet/release/src/vehicle/Iibsrc/libSendNel/laser_range.c) 

Includes: 

"sendjoc.h" 

"veh_app_loc.h" 

"pro_data.h" 

"pro_size.h" 


2.1.1.3.1.29.1  network_send_laser_range 
This  routine  sends  a  Laser  Range  PDU. 


1  Parameters  1 

Parameter 

Tvne 

Where  Typedef  Declared 

result 

LaserRanaeResult 

D  data.h 

LRswitch 

ReturnSwitch 

p  data.h 

taroetlD 

pointer  to  TaraetDescriptor 

basic.h 

laser  tlofl 

double 

Standard 

locationfi 

double 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

Ddu 

DataCollectionPDU 

D  data.h 

pkt 

register  pointer  to 
LaserRanqeVariant 

p.data.h 

1  Calls  1 

Function 

Where  Described 

network  fill  hdr  send  dc  okt 

Section  2.1.1.3.1.42.6 

PRO  DATA  LASER  RANGE  SIZE 

D  size.h 

Table  2.1-32:  network_send_laser_range  Information. 


2.1.1.3.1.30  laser_result.c 

(./sinmet/release/src/vehicle/libsr<^bSendNet/laser_rcsult.c) 

Code  in  this  file  is  not  compiled  in  the  Version  6.6  release. 
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2.1.1.3.1.31  missile.c 

(ysimnet/nelease/src/vehicle/Iibsrc/libSendNet/missile.c) 


Includes: 

”stdio.h" 

‘‘math.h" 

"sendjoc.h" 

"veh_app_loc.h" 

"pro_sim.h" 

"pn)_size.h" 

"mun_type.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libimss_dfn.h" 

"timers_dfn.h" 

"sim_ammo.h" 


Defines: 

MAX_DEAD_RECK_ERROR  -  in  meters 

FIRST_MISSILE_ID 

LAST_MISSILE_ID 

Typedefs: 

MISSILE_INFO  -  contains  missile  information,  including  the  eventID  of  the 
missile  in  flight,  the  dead  reckoned  position  of  the  missile, 
the  velocity,  and  the  first  chord  for  Ae  missile. 


£)eclarations: 

in_flight[MAX_MISSILE_IDS] 

missile_vap_buf  -  contains  the  static  vehicle  appearance  PDU  information  for 
missiles. 

missiles.inited 

num_missiles_flying 

2.1.1.3.1.31.1  network_missiles_init 

This  routine  intializes  the  missile  appearance  packet  structures  to  zero. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

Int 

Standard 

vap 

pointer  to 

Vehicle  AppearanceVariant 

p_sim.h 

Table  2.1-33:  network_inissiles_init  Information. 
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2.1.1.3.1.31.2  network_send_missile_appearance 

This  routine  sends  a  missile's  appearance  packet.  When  a  vehicle  fires  a  missile,  the 
network  is  sent  separate  appearance  packets  for  the  vehicle  and  the  missile.  The  missile  is 
treated  as  a  separate  vehicle  by  the  network. 


Parameter 


vehicle 


chord_8tart 


chord  end 


onentation 


veloct 


r 


uises 


Parameters 


unsioned  short 


VECTOR 


VECTOR 


T  MATRIX 


VECTOR 


inter  to  VehicleGuises 


Where  Tvpedef  Declared 


Standard 


es.h 


lESZigl 


I  ESS? 


basic,  h 


Variable 


vap 


X  diff 


diff 


z  diff 


Internal  Variables 


register  pointer  to 
VehicleAppearanceVariant 


register  pointer  to 
MISSILE  INFO 


float 


float 


float 


Where  Typedef  Declared 


p_sim.h 


Standard 


Standard 


Standard 


Return  Value 


FALSE 


TRUE 


Return  Values 


Meanin 


either  the  missile  appearance 
was  not  initialized,  the  missile's 
rotation  vector  is  invalid,  or  it 
has  an  invalid  missile  vehicle  id 


appearance  packet  was  sent 


Function 


vec  CO 


d2f  mat  CO 


net  current  time 


network  pet  net  handle 


fmat  check 


vec  dum 


dump  core 


network  fill  hdr  send  sIm  okt 


PRO  SIM  APPEARANCE  SIZE 


Calls 


Where  Described 


Section  2.6.2.59.1 


Section  2.6.2.1.1 


See  MCC  CSCI  Section  2.20.2.8.3 


Section  2.1.1.3.2.12.1 


Section  2.6.2.11.1 


Section  2.6.2.60.1 


Section  2.6.4.13.1 


Section  2.1.1.3.1.42.5 


size.h 


in 


Table  2.1>34:  network_send_inissile_appearance  Information. 


44 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.1.1.3.1.31.3  network_stop_inissile_fl  you  t 

This  routine  is  called  to  deactivate  a  missile  when  it  is  no  longer  flying  out.  The  missile 
must  have  been  initialized  and  flown  out  in  order  to  be  deactivated,  l^e  missile  may  have 
stopped  flying  out  either  because  it  impacted  or  because  it  flew  out  of  the  terrain  database 
ran^.  The  routine  checks  to  ensure  tiiat  the  missile  has  not  already  been  deactivated,  and 
then  sends  a  Deactivate  PDU  over  the  networic  ro  unform  the  world  that  the  missile  is  gone 
Once  the  missile  is  deactivated,  its  appearance  packet  structure  is  reinitialized. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

vehicle 

unsianed  short 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Ddu 

SimulationPDU 

p  sim.h 

pkt 

register  pointer  to 
DeactivateRequestVariant 

p_sim.h 

i 

int 

Standard 

curr  miss 

pointer  to  MISSILE  INFO 

Calls 

Function 

Where  Described 

network  fill  hdr  send  sim  okt 

Section  2.1.1.3.1.42.5 

PRO  SIM  DEACTIVATE  REQ  SIZE 

D  size.h 

Table  2.1-35:  network_stop_inlssile_flyout  Information. 
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2.1.1.3.1.31.4  net  work_send_missile_fire_pkt 

This  routine  sends  a  Fire  PDU  describing  the  firing  of  a  missile,  in  order  for  the  world  to 
make  the  appropriate  sound  and  visual  effects. 


Parameter 


eventID 


muzzle 


veloci 


tube 


Parameters 


EventID 


int 


ObiectTvoe 


unsianed  short 


unsioned  short 


unsianed  char 


inter  to  VehicietD 


WoridCoordinates 


VelocitvVector 


int 


l|7 


Where  Tynedef  Declared 


basic.h 


Standard 


sim.h 


Standard 


Standard 


Standard 


basic.h 


basic.h 


basic.h 


Standard 


Variable 


du 


kt 


curr  miss 


vehicle 


Internal  Variables 


SimulationPDU 


register  pointer  to  FireVariant 


register  int 


register  pointer  to 
MiSSILE  INFO 


int 


Where  Tvoedef  Declared 


sim.h 


sim.h 


Standard 


in 

in 


Standard 


Return  Value 


vehicle 


-1 


Return  Values 


Meanin 


the  missile  vehicle  ID 


no  missile  available 


Function 


e  from  ammo  ent 


vec  CO 


fvec  CO 


network  fill  hdr  send  sim 


PRO  SIM  FIRE  SIZE 


Calls 


Where  Described 


Section  2.6.11.2.3 


Section  2.6.2.59.1 


Section  2.6.2.26.1 


Section  2.1.1.3.1.42.5 


size.h 


in 


Table  2.1-36:  network_send_missile_fire_pkt  Information. 
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2.1.1.3.1.32  net_xinit.c 

(ysiinhet/release/src/vehicle/Iibsrc/libSendNei/net_xmit.c) 


Includes: 

"sendjoc.h" 

"veh_app_loc.h" 

"pro_sim.h" 

"pro_size.h" 

''pio_data.h" 

"pio_mgmt.h'' 

"pro_timers.h" 

"veh_type.h" 

"Ubfail.h" 

"Ubhull.h" 

Declaiatirais: 

force_sending_veh_status  -  set  equal  to  FALSE 

Defines: 

VEH_STATUS_MODE 

EQUIP_STATUS_MODE 

XMTT.OTHER 

2.1.1.3.1.32.1  need__to_sen  d_veh_status 

This  routine  is  called  in  order  to  send  a  Vehicle  Status  PDU,  regardless  of  the  timing.  For 
example,  "ml.ammo.c"  calls  this  routine  when  ammunition  quantities  change. 

2.1.1.3.1.32.2  network_xinit 

This  routine  sends  out  three  types  of  packets  at  regular  intervals  specified  by  the  protocol. 
The  routine  determines  when  to  send  out  these  appearance  packets,  equipment  status 
packets  and  simulation  status  packets,  and  then  sends  them. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

time  since  iast  other 

int 

Standard 

xmit  state 

short 

Standard 

Calls 

Function 

Where  Described 

format  vehicle  atvearance 

Section  2.1.1 .3.1. 4.1 

network  check  veh  aooearance 

Section  2.1.1.3.1.66.4 

send  vehicle  status 

Section  2.1.1.3.1.71.1 

send  eauipment  status 

Table  2.1-37:  network  xmit  Information. 
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2.1.1.3.1.32.3  network_xniit_idle 

This  routine  detennines  when  to  transmit  equipment  status  packets  that  must  be  sent  when 
the  simulatitm  is  in  idle  state,  or  is  uninitialized.  The  packets  are  sent  at  a  rate  specified  in 
"pro_timers.h". 


Internal 

Variables 

Variable 

Type 

Where  Tvoedef  Declared 

counter 

int 

Standard 

Calls 

■  Function 

Where  Described 

1  send  eauioment  status 

Table  2.1*38:  network  xmit  idle  Information. 
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2.1.1.3.1.33  non_impact.c 

(ysininel/release/src/vehicle/libsrc/libSendNet/non_impact.c) 

Includes: 

"send_loc.h" 

"pro_sim.h" 

"pro_size.h" 

"mun_type.h" 

"sim_ammo.h" 

"veh_app_loc.h" 

"Ubmap.h" 

"basic.h" 

Declarations; 

null_vehicleID 

null_vehicle_coords 

null_world_coords 

2.1.1.3.1.33.1  network_send_non_iinpact 


This  routine  sends  an  Impact  PDU  describing  a  non-impact. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

eventID 

EventID 

basic.h 

ammo  tvoe 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

Ddu 

SimulationPDU 

p  sim.h 

pkt 

register  pointer  to 

ImpactVarlant 

p_sim.h 

1  Calls  1 

Function 

Where  Described 

mao  aet  network  type  from  ammo  entry 

Section  2.6.11.2.3 

yec  copy 

Section  2.6.2.59.1 

fvec  copy 

Section  2.6.2.26.1 

network  fill  hdr  send  sim  pkt 

Section  2.1.1.3.1.42.5 

PRO  SIM  IMPACT  SIZE 

p  size.h 

Table  2.1-39:  network_send_non_iinpact  Information. 
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2.1.1.3.1.34  nprintf.c 

(ysimneVrelease/src/vehicle/libsrc/libSendNet/nprintf.c) 

Includes: 

"stdio.h" 

"varargs.h" 

"sendjoc.h" 

"pro_assoc.h" 

”piD_nigmt.h” 

"pro_size.h" 

2.1.1.3.1.34.1  nprintf 

This  utility  routine  creates  a  function  similar  to  the  standard  C  function  "printf '  which, 
instead  of  printing  to  the  screen,  sends  an  Error  PDU  out  to  the  network  under  the 
Management  Protocol.  This  routine  uses  the  standard  C  VARARG  capability  for  handling 
variable  argument  lists. 


1  Parameters  1 

1  Parameter 

Where  Tvpedef  Declared 

Iva  alist 

va  del 

Standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

fmt 

pointer  to  char 

Standard 

ap 

va  list 

Standard 

buf[maxNetworkPDUSize  / 
sizeofdonad 

long 

Standard 

pdu 

pointer  to  ManaaementPDU 

p  mamt.h 

pkt 

register  pointer  to 
ErrorReportVariant 

p_mgmt.h 

text 

pointer  to  char 

Standard 

pointer  to  AssociationPDU 

p  assoc,  h 

Imax  size 

int 

Standard 

Ibuf  size 

int 

Standard 

extern  pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

PRO  ASSOC  DATAGRAM  HDR  SIZE 

p  size.h 

PRO  MGMT  ERROR  REPORT  SIZE 

p  size.h 

format  decoder 

Section  2.6.4.15.3 

network  fill  hdr  send  mamt  pkt 

Section  2.1.1.3.1.42.7 

PRO  MGMT  ERROR  REPORT  SIZE 

p  size.h 

Table  2.1*40:  nprintf  Information. 
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2.1.1.3.1.35  position.c 

(./simnetA«Iease/src/veh’cle/Iibsrc/libSendNet/position.c) 

Code  in  this  file  is  not  compiled  in  the  Version  6.6  release. 

2.1.1.3.1.36  power  supply.c 

(ysimnet^lease/src/vehicle/libsr(VlibSendNet^ower_supply.c) 

Code  in  this  Ble  is  not  compiled  in  the  Version  6.6  release. 

2.1.1.3.1.37  reloadReq.c 

(ysimnetAelease/srcA'ehicle/libsrc/libSendNet/reloadReq.c) 

Code  in  this  file  is  not  compiled  in  the  Version  6.6  release. 

2.1.1.3.1.38  repaired.c 

(./simnet/release/src/vehicle/libsrc/libSendNet/rcpaired.c) 


Includes; 

"sendjoc.h" 

"veh_app_loc.h" 

"pro_assoc.h" 

"pro_sim.h" 

"pro_size.h" 


2.1.1.3.1.38.1  send_repaired_pkt 

This  routine  sends  a  transaction  response  to  a  Repair  Request  PDU. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

supplierlD 

pointer  to  VehiclelD 

basic.h 

result 

RepairResult 

p  sim.h 

oriainator 

pointer  to  SimulationAddress 

address. h 

tid 

T  ransactionidentifier 

address.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Ddu 

SimulationPDU 

p  sim.h 

pkt 

register  pointer  to 
RepairResponseVariant 

p_sim.h 

Calls 

Function 

Where  Described 

network  fill  hdr  send  sim  rsp 

Section  2.1.1.3.1.46.1 

PRO  SIM  REPAIR  RESPONSE  SIZE 

p  size.h 

Table  2.1>41:  send_repaired_pkt  Information. 
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2.1.1.3.1.39  resupp_cancl.c 

(ysimnet^lease/srcA'ehicle/libsrc/libSendNei/resupp_cancl.c) 

This  Ble  is  not  used  in  the  version  6.6  release. 

2.1.1.3.1.40  resupp_offer.c 

(ysimnet/release/src/vehicle/libsrc/libSendNet/rcsupp_offer.c) 


Includes: 

"sendjoc.h" 

"veh_app_loc.h" 

"pro_sim.h" 

"pro_size.h" 

"mun_type.h" 


2.1.1.3.1.40.1  networ  k_sen  d_offer_packet 

This  routine  sends  a  Resupply  Offer  PDU  using  the  underlying  datagram  service. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

receiverlD 

pointer  to  VehiclelD 

basic.h 

num  munitions 

unsigned  char 

Standard 

munitions 

pointer  to  unsigned  char 

Standard 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

pdu 

SimulationPDU 

p  sim.h 

pkt 

register  pointer  to 
ResupplyVariant 

p_sim.h 

i 

register  int 

Standard 

1  Calls  1 

Function 

Where  Described 

network  get  vehicle  type 

Section  2.1.1.3.1.23.1 

network  get  simulator  type 

Section  2.1.1.3.1.19.1 

network  fill  hdr  send  sim  pkt 

Section  2.1.1.3.1.42.5 

PRO  SIM  RESUPPLY  OFF  SIZE 

p  size.h 

Table  2.1>42:  network_send_offer_packet  Information. 
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2.1.1.3.1.41  resupp_recvd.c 

(7simnet/release/src/vehicle/libsrcAibSendNet/resupp_recvd.c) 


Includes: 

"sendjoc.h" 

"veh_app_loc.h" 

"mun_t5^.h" 

"pro_sim.h" 

"pro_size.h" 

2.1.1.3.1.41.1  network_send_thank_you_packet 

This  routine  sends  a  Resupply  Received  PDU  using  the  underlying  datagram  service. 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

suDDlierlD 

pointer  to  VehiclelD 

basic,  h 

num  munitions 

unsioned  char 

Standard 

nrujnitions 

register  pointer  to 
MunitionQuantity 

basic.h 

tid 

T  ransactionidentif  ier 

address.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

pdu 

SimulationPDU 

P  sim.h 

pkt 

register  pointer  to 
ResupplyVariant 

p_sim.h 

i 

register  int 

Standard 

1  Calls  1 

Function 

Where  Described 

network  aet  vehicle  type 

Section  2.1.1.3.1.23.1 

network  aet  simulator  type 

Section  2.1.1.3.1.19.1 

network  fill  hdr  send  sim  pkt 

Section  2.1.1.3.1.42.5 

PRO  SIM  RESUPPLY  RECEIVED  SIZE 

D  size.h 

Table  2.1-43:  network_send_thank_you_packet  Information. 
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2.1.1.3.1.42  send_dg  pkt.c 

(ysimnet/reIease/src/vehicle/libsr<^bSendNei/send_dg_pkLc) 

This  file  contains  the  routines  that  fill  PDU  headers  for  datagrams  and  that  call  the  net 

interface  to  send  them  out 

Includes: 

"stdio.h" 

"pro_sim.h" 

"pro_data.h" 

"pro_mgmth" 

’’p_ivis.h" 

"sendjoc.h" 

"veh_app_loc.h" 

"net_stats.h" 

2.1.1.3.1.42.1  riil_simHdr 

This  routine  fills  the  header  for  Simulation  PDUs. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

Ddu 

pointer  to  SimulationPDU 

p  sim.h 

pduKind 

SimulationPDUKind 

p  sim.h 

Table  2.1>44:  flll_simHdr  Information. 

2.1.1.3.1.42.2  nil_mgmtHdr 

This  routine  tills  the  header  for  Management  PDUs. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pdu 

pointer  to  ManaaementPDU 

p  mamt.h 

PduKind 

ManaaementPDUKind 

p  mamt.h 

Table  2.1>45:  fill_mgmtHdr  Information. 

2.1.1.3.1.42.3  filMvisHdr 

Code  in  this  routine  is  not  used  in  the  Version  6.6  release. 

2.1.1.3.1.42.4  rill_dcHdr 

This  routine  fills  the  header  for  Data  Collection  PDUs. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Pdu 

pointer  to  OataCollec^fonPOU 

p  data.h 

PduKind 

DataCollectionPDUKind 

p  data.h 

Table  2.1>46:  fill  dcHdr  Information. 
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2.1.1.3.1.42.5  network_fin_hd  r_send_sim_pkt 

This  routine  sends  out  Simulation  Protocol  datagrams.  It  calls  the  routine  fill  simHdrO 
to  fill  the  packet  header,  and  then  calls  the  netwo^  interface  to  send  out  the  packet 


Parameters 


Parameter 

Type 

Where  Tvpedef  Declared 

Ddu 

pointer  to  SimulationPOU 

p  sim.h 

DduSize 

int 

Standard 

oduKind 

SimulationPOUKind 

p  sim.h 

Calls 

Function 

Where  Described 

fill  simHdr 

Section  2.1.1.3.1.42.1 

AssocSendOataaram 

See  MCC  CSCI  Section  2.20.1.2.1 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

NOTE  SENT 

Table  2.1-47:  network_fiII_hdr_send_sim_pkt  Information. 


2.1.1.3.1.42.6  network_fiII_hdr_send_dc_pkt 


This  routine  sends  out  Data  Collection  Protocol  datagrams.  It  calls  the  routine 

fill  dcHdrO  to  fill  the  packet  header,  and  then  calls  the  network  interface  to  send  out  the 

packet 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

pdu 

pointer  to  DataCollectionPDU 

p  data.h 

pduSize 

int 

Standard 

pduKind 

DataCollectionPDUKind 

p  data.h 

Calls 

Function 

Where  Described 

fill  dcHdr 

Section  2.1.1.3.1.42.4 

AssocSendOataaram 

See  MCC  CSCI  Section  2.20.1.2.1 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

NOTE  SENT 

Table  2.1-48:  network_fill_hdr_send_dc_pkt  Information. 
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2.1.1.3.1.42.7  network_fill_hdr_send_mgmt_pkt 

This  routine  sends  out  Management  Protocol  datagrams.  It  calls  the  routine 
fill_mgmtHdrO  to  fill  the  packet  header,  and  then  calls  the  network  interface  to  send  out 
the  packet 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Ddu 

pointer  to  ManaaementPDU 

D  data.h 

DduSize 

int 

Standard 

oduKind 

ManaaementPDUKind 

p  mgmt.h 

1  Calls  1 

■  Function  I 

Where  Described 

illllii  liiili'  I———— 

Section  2.1.1.3.1.42.2 

AssocSendDataaram 

See  MCC  CSCI  Section  2.20.1.2.1 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

NOTE  SENT 

Table  2.1-49:  network_fill_hdr_send_mgmt_pkt  Information. 

2.1.1.3.1.42.8  net  work_fill_hd  r_send_i  vis_pk  t 

Code  in  this  routine  is  not  used  in  the  Version  6.6  release. 

2.1.1.3.1.43  sendjoc.c 

(./simn5/release/src/vehicle/libsrc/libSendNet/send_loc.c) 

This  file  contains  data  definitions  for  local  data  stmctures. 

Includes: 

"sim_types.h" 

"sim_^ns.h" 

"send_loc.h" 

"net_stats.h" 

"net/network.h" 

"pro_sim.h" 

"veh_type.h" 

Declarations: 

netxmt_failed 

packets_sent[maxProtocolFamily+l][maxPacketsPerFamily] 
features  -  used  to  set  special  features  such  as  tow  down 

veh_app_buf 
init_buf 

app_pkt  -  declared  externally  in  "veh_app_loc.h" 

init_pkt  -  declared  externally  in  "veh_app_loc.h" 

my_simulator_type  -  describes  the  type  of  simulator  (i.e.,  an  Ml  simulator  or  an 

M2  simulator) 
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2.1.1.3.1.44  send_loc.h 

(ysimnetAelease/src/vehicle/libsrc/iibSendNet/sendJoc.h) 

This  file  contains  local  only  #defines  and  declarations. 

2.1.1.3.1.45  send_pt  pkt.c 

(ysimnetA'3ease/src/vehicle/libsic/libSendNet/send_pt_pkt.c) 


Includes: 

"stdio.h" 

"basic.h" 

*'pro_assoc.h" 

"p2p.h’' 

"send_loc.h" 


2.1.1.3.1.45.1  send_pt_packet 

This  routine  sends  a  point  to  point  packet. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

but 

Dointertochar 

Standard 

DduSize 

int 

Standard 

exerdselD 

Exercise!  0 

basic.h 

orotocol 

AssociationUserProtocol 

D  assoc.h 

addr 

pointer  to  SimulationAddress 

address.h 

1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

int 

either  not  using  ethernet  or 
transmission  failed 

TRUE 

int 

procedure  was  successful 

1  Calls  1 

Function 

Where  Described 

PointToPointSendPDU 

Section  2.1.1.2.2.2.1 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

Table  2.1-50:  send_pt_packet  Information. 
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2.1.1.3.1.46  send_rsp.c 

(ysimnetAelease/src/vehicle/libsrc/libSendNet/send_rsp.c) 

This  file  contains  routines  for  sending  responses  to  transaction  requests. 

Includes; 

"stdio.h" 

"sim_dfns.h" 

"pro_assoc.h" 

"pro_sim,h" 

"pro_data.h" 

"pro_num.h" 

"net_stats.h" 

2.1.1.3.1.46.1  net  work_fi  ll_h  dr_send_sim_rsp 

This  routine  fills  the  PDU  headers  for  Simulation  Protocol  transaction  responses,  and  calls 

the  network  interfaces  to  send  them  out. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

pdu 

register  pointer  to 
SimulationPDU 

p_sim.h 

size 

int 

Standard 

kind 

SimulationPOUKind 

p  sim.h 

orioinator 

DOinter  to  SimulationAddress 

address.h 

tid 

Transactionidentifier 

address.h 

cache 

int 

Standard 

1  Calls  1 

Function 

Wherr  Described 

fill  simHdr 

Sectloti  ?  M. 3.1 .42.1 

AssocSendResoonse 

See  MCC  CSCI  Section  2.20.1.4.2 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

NOTE  SENT 

Table  2.1-51:  network_fiII_lidr_send_sim_rsp  Information. 
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2.1.1.3.1.46.2  network_fill_hdr__sen<l_dc_rsp 

This  routine  fills  the  PDU  headers  for  Data  Collection  Protocol  transaction  responses,  and 
calls  the  network  interfaces  to  send  them  out. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pdu 

register  pointer  to 
OataCollectionPOU 

p_data.h 

size 

int 

Standard 

kind 

DataCollectionPDUKind 

p  data.h 

oriainator 

pointer  to  SimulationAddress 

address.h 

cache 

int 

Standard 

Calls 

Function 

Where  Described 

fill  dcHdr 

Section  2.1.1.3.1.42.4 

AssocSendResponse 

See  MCC  CSC!  Section  2.20.1.4.2 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

NOTE  SENT 

Table  2.1-52:  network_fill_hdr_send_dc_rsp  Information. 
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2.1.1.3.1.47  send_trans.c 

(ysinmelAelease/src/vehicle/libsic/libSenciNet/send_trans.c) 

This  file  contains  routines  for  sending  transactions. 

Includes: 

’•stdio.h" 

"sim_dfns.h" 

"pro_assoc.h" 

"pro_sim.h" 

"pro_data.h" 

"pn)_num.h" 

2.1.1.3.1.47.1  network  nil  hdr  send  sim  trans 


This  routine  fills  the  PDU  headers  for  Simulation  Protocol  transactions,  and  calls  the 
network  interface  to  send  them  out 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pdu 

register  pointer  to 
SimulationPDU 

p_sim.h 

size 

int 

Standard 

kind 

SimulationPDUKind 

p  sim.h 

respondent 

pointer  to  SimulationAddress 

address.h 

(callbacklO 

pointer  to  int 

Standard 

cparam 

pointer  to  Iona  int 

Standard 

(timeout)  0 

pointer  to  int 

Standard 

pointer  to  Iona  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

int 

the  transaction  failed 

TRUE 

int 

the  transaction  was  successful 

1  Calls  1 

Function 

Where  Described 

fill  simHdr 

Section  2.1.1.3.1.42.1 

AssocSendT  ransact 

See  MCC  CSCI  Section  2.20.1.4.1 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

Table  2.1-53:  network_fill_hdr_send_sim_trans  Information. 
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2.1.1.3.1.47.2  network  fill  hdr  send  dc  trans 


This  routine  fills  the  PDU  headers  for  Data  Collection  Protocol  transactions,  and  calls  the 
network  interface  to  send  them  out 


1  Parameters  I 

Parameter 

Tvne 

Where  Typedef  Declared 

pdu 

register  pointer  to 
DataCollectionPDU 

p.data.h 

size 

int 

Standard 

kind 

DataCollectionPDUKind 

p  data.h 

respondent 

DOinter  to  SimulationAddress 

address.h 

(caliback)O 

pointer  to  int 

Standard 

coaram 

pointer  to  Iona  int 

Standard 

(timeoutlO 

pointer  to  int 

Standard 

pointer  to  Iona  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

int 

the  transaction  failed 

TRUE 

int 

the  transaction  was  successful 

1  Calls  1 

Function 

Where  Described 

fill  dcHdr 

Section  2.1.1.3.1.42.4 

AssocSendT  ransact 

See  MCC  CSCI  Section  2.20.1.4.1 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

Table  2.1«54:  network_fill__hdr_send_dc__trans  Information. 
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2.1.1.3.1.48  service_req.c 

(7simnet/release/src/vehicle/libsrc/libSen(iNet/service_req.c) 


Includes: 

"sendjoc.h" 

"veh_app_loc.h" 

"pro_sim.h" 

"mun_type.h" 

2.1.1.3.1.48.1  network_send_feed_me_packet 


This  routine  sends  a  Service  Request  PDU  using  the  underlying  datagram  service. 


1  Parameters  1 

1  Parameter  1 

Type 

Where  Typedef  Declared 

1  'i|  'll 

pointer  to  VehiclelD 

basic.h 

num  munitions 

unsianed  char 

Standard 

munitions 

register  pointer  to 
MunitionQuantity 

basic.h 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

Ddu 

SimulationPDU 

p  sim.h 

pkt 

register  pointer  to 
ResupplyVariant 

p_sim.h 

i 

1  III!  Ill  III  H^— 

Standard 

1  Calls  1 

Function 

Where  Described 

network  aet  vehicle  type 

Section  2.1.1.3.1.23.1 

network  aet  simulator  type 

Section  2.1.1.3.1.19.1 

network  fill  hdr  send  sim  pkt 

Section  2.1.1.3.1.42.5 

PRO  SIM  SERVICE  REQ  SIZE 

p  size.h 

Table  2.1-55:  network_send_feed_me_packet  Information. 
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2.1.1.3.1.49  set_ex  id.c 

(ysinmet^lease/src/vehicle/libsrc/libSendNet/set_ex_id.c) 


Includes: 

"sendjoc.h" 

"veh_app_loc.h" 

2.1.1.3.1.49.1  network_set_exercise_id 

This  routine  changes  the  exercise  ID  stored  in  the  Vehicle  Appearance  PDU  to  new  jd. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

new  id 

ExerciselD 

basic.h 

Table  2.1-56:  network_set_exercise_id  Information. 

2.1.1.3.1.50  set_force.c 

(./sirnhet/release/src/vehicle/libsrc/libSendNet/set_farce.c) 


Includes: 

"sendjoc.h" 

"veh_appJoc.h" 

2.1.1.3.1.50.1  network_set_force 

This  routine  changes  the  force  ID  stored  in  the  Vehicle  Appearance  PDU  to  force. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

force 

ForcelD 

basic.h 

Table  2.1-57:  network_set_force  Information. 

2.1.1.3.1.51  set_guises.c 

(ysiirinet/rBlease/src/vehicle/libsrc/libSendNet/set_guises.c) 


Includes: 

"pro_sim.n" 

"sendjoc.h" 

"veh_appJoc.h" 

2.1.1.3.1.51.1  network_set_vehicle_guises 

This  routine  changes  the  vehicle's  guises  stored  in  the  Vehicle  Appearance  PDU  to  guises. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

auises 

pointer  to  VehicleGuises 

basic.h 

Table  2.1-58:  network_set_vehicle_guises  Information. 
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2.1.1.3.1.52  set_siin  type.c 

(ysimhetA'Sease/srcA'ehicle/libsrc/IibSendNet/set_sim_type.c) 


Includes: 

"send_loc.h" 

"veh_app_loc.h" 

2.1.1.3.1.52.1  net  work_set_siinula  tor_ty  pe 

This  routine  changes  the  simulator  to  the  type  passed  in  type. 


1  Parameters  1 

1  Parameter 

Tvne 

Where  Tvpedef  Declared 

Itvoe 

SimulatorTvoe 

basic,  h 

Table  2.1-59:  network_set_simulator_type  Information. 

2.1.1.3.1.53  set_veh_app.c 

(ysiimietA«lease/src/vehicle/libsrc/libSendNet/set_veh_app.c) 


Includes: 

"pro_sim.h" 

"send_loc.h" 

"veh_appJoc.h" 

2.1.1.3.1.53.1  network_set_vehicle_appearance 

This  routine  changes  the  vehicle's  appearance  stored  in  the  Vehicle  Appearance  PDU  to 
nsw_qppearance. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

new.  aopearance 

unsianed  Iona 

Standard 

Table  2.1-60:  network_set_vehicle_appearance  Information. 
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2.1.1.3.1.54  set_veh  clas.c 

(ysiinnetAeIease/src/vehicle/Iibsrc/IibSendNet/set_veh_clas.c) 

Includes: 

"stdio.h" 

"send_loc.h" 

"veh_app_loc.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmain.h" 

2.1.1.3.1.54.1  network  set  vehicle  class 


This  routine  changes  the  vehicle's  class  stored  in  the  Vehicle  Appearance  PDU  to 
new  class. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

new  class 

unsigned  char 

Standard 

Table  2.1>61:  network  set  vehicle  class  Information. 


2.1.1.3.1.55  set_veh  id.c 

(./siinhet/reiease/src/vehicle/libsrc/libSendNet/set_veh_id.c) 

Includes: 

"pro_sim.h’' 

"sendjoc.h" 

"veh_app_loc.h" 

2.1.1.3.1.55.1  network  set  vehicle  id 


This  routine  sets  the  vehicle's  ID  number  stored  in  the  Vehicle  Appearance  PDU  to  newjd. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

1  new  id 

pointer  to  VehiclelD 

basic. h 

Called  By 

Function 

W'lere  Described 

network  init 

Section  2.1.1.3.2.12.3 

Table  2.1-62:  network_set_vehicle_id  information. 
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B 


2.1.1.3.1.56  set_xmt_fail.c 

(ysimhet/release/src/vehicle/libsrc/libSendNet/set_xmt_fail.c) 

Includes: 

"sendjoc.h" 

2.1.1.3.1.56.1  set_xmt_failed 

This  routine  sets  the  netxmt  Jailed  flag  to  either  TRUE  or  FALSE.  It  can  be  used  during 
debugging  to  check  whether  network  transmissions  are  working. 


_ _ Parameters _ _ 

Parameter  Type  Where  Typedef  Declared 

state  BOOLEAN  sim  tvpes.h 

Table  2.1*63:  set  xmt  failed  Information. 
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2.1.1.3.1.57  shell_fire.c 

(ysimn5Aelease/src/vehicle/libsrc/libSendNet/shell_fire.c) 

Includes: 

"send_loc.h" 

"veh_app_loc.h" 

"mun_type.h" 

"pro_sim.h" 

"pro_size.h" 

"sim_ammo.h" 

"libmap.h" 

Declarations: 

null_vehicleID 

2.1.1.3.1.57.1  net  work_send_shell_fi  re_pkt 

This  routine  sends  a  Fire  PDU  describing  the  firing  of  a  shell,  in  order  for  the  world  to 

make  the  appropriate  sound  and  visual  effects. 


Parameter 


eventID 


detonator  tvoe 


slew  rate 


ammoSelected 


Parameters 


EventID 


int 


ObiectTyoe 


unsioned  short 


unsioned  short 


unsioned  short 


inter  to  VehicielD 


WorldCoordinates 


Velocitvvector 


float 


float 


ObiectTvoe 


in 


Where  Tvoedef  Declared 


basic.h 


Standard 


sim.h 


Standard 


Standard 


Standard 


basic.h 


basic.h 


basic.h 


Standard 


Standard 


sim.h 


in 


Variable 


du 


kt 


Internal  Variables 


e 


SimulationPDU 


register  pointer  to  FireVanant 


lEnn 


in 

in 


Where  Typedef  Declared 


sim.h 


sim.h 


Function 


et  network  type  from  ammo  ent 


vec  CO 


network  fill  hdr  send  sim 


PRO  SIM  FIRE  SIZE 


ns 


Calls 


Where  Described 


Section  2.6.11.2.3 


Section  2.6.2.59.1 


Section  2.6.2.26.1 


Section  2.1.1.3.1.42.5 


size.h 


in 


Table  2.1-64:  network_send_sheIl_flre_pkt  Information. 
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2.1.1.3.1.58  show_effect.c 

(ysimnet/release/src/vehicle/libsic/libSendNet/show_effect.c) 

Code  in  this  file  is  not  compiled  in  the  Version  6.6  release. 

2.1.1.3.1.59  sim_status.c 

(7simnet^lease/src/vehiclc/libsrt^bSendNet/sim_status.c) 


Includes: 

"sys/type.h" 

"sys/timeb.h" 

"send_loc.h" 

"veh_app_loc.h" 

"piD_data.h" 

"pro_assoc.h" 

"pro_si2e.h" 

"pTO_num.h" 

"net_stats.h" 

2.1.1.3.1.59.1  send_simulation_status_pkt 

This  routine  sends  a  Simulation  Status  PDU  using  the  datagram  service. 


I  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

1  exercise 

ExerciselD 

basic,  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

pdu 

OataCollectionPDU 

p  data.h 

pkt 

register  pointer  to 
SimulationStatusVariant 

p_data.h 

current  time 

struct  timeb 

Standard 

elapsed  time 

Iona 

Standard 

Calls 

Function 

Where  Described 

network  aet  simulator  type 

Section  2.1.1.3.1.19.1 

timers  elapsed  milliseconds 

Section  2.6.3.10.1 

AssocSendOataaram 

See  MCC  CSCI  Section  2.20.1.2.1 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

PRO  DATA  SIMULATION  STATUS  SIZE 

p  data.h 

NOTE  SENT 

Table  2.1>65:  send_simulation_status_pkt  Information. 
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2.1.1.3.1.59.2  sen  d_simulation_status_trans 

This  routine  sends  a  Simulation  Status  PDU  using  the  transaction  service. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ortainator 

pointer  to  SimulationAddress 

address.h 

tid 

T  ransactionidentilier 

address.h 

exercise 

ExerciselD 

basic.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Ddu 

DataCollectionPDU 

p  data.h 

pkt 

register  pointer  to 
SimulationStatusVariant 

p_data.h 

elapsed  time 

long 

Standard 

current  time 

stmct  timeb 

Standard 

Calls 

Function 

Where  Described 

timers  elapsed  milliseconds 

Section  2.6.3.10.1 

AssocSendT  ransact 

See  MCC  CSCI  Section  2.20.1.4.1 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

PRO  DATA  SIMULATION  STATUS  SIZE 

D  size.h 

NOTE  SENT 

Table  2.1>66:  send_simulation_status_trans  Information. 


2.1.1.3.1.<i0  spec_appear.c 

(./simnetAelease/src/vehicle/libsrc/libSendNet/spec_appear.c) 

The  routine  in  this  file  is  stubbed  in  anticipation  of  a  later  release. 

2.1.1.3.1.61  spec_status.c 

(./simnetAelease/src/vehicle/libsrc/libSendNet/spec_status.c) 

The  routine  in  this  file  is  stubbed  in  anticipation  of  a  later  release. 
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2.1.1.3.1.62  stat_change.c 

(ysimnetABlease/src/vehicle/iibsrc/libSendNet/stat_change.c) 


Includes: 

"scnd_loc.h" 

"veh_app_loc.h" 

"pro_data.h" 

"pro_size.h" 


2.1.1.3.1.62.1  net  wor  k_sen  d_status_chan  ge 

This  routine  sends  a  Status  Change  PDU  to  notify  the  wwld  that  a  change  in  vehicle  status 
has  occurred.  The  routine  assumes  that  all  bits  are  set  for  VehicleSubsystemStatus  in  a 
global  place  in  memory.  The  change  in  vehicle  status  may  be  due  to  the  vehicle  being 
destroyed  or  recreated,  or  to  vehicle  subsystems  being  damaged  or  repaint. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

effect 

StatusChanaeEffect 

p  data.h 

cause 

int 

Standard 

pointer  to  VehiclelD 

basic,  h 

eventID 

EventID 

basic.h 

subsystem 

pointer  to  VehicleSubsystems 

status.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

pdu 

DataColledionPDU 

p  data.h 

pkt 

register  pointer  to 
StatusChanaeVariant 

p_data.h 

1  Calls  1 

Function 

Where  Described 

network  fill  hdr  send  dc  pkt 

Section  2.1.1.3.1.42.6 

PRO  DATA  STATUS  CHANGE  SIZE 

p  size.h 

Table  2.1-67:  network_send_status_change  Information. 
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2.1.1.3.1.63  stat_rsp.c 

(ysimnet/release/src/vehicle/libsrc/libSendNet/stat_rsp.c) 


"stdio.h" 

"sim_macros.h" 

"send_loc.h" 

"veh_app_loc.h" 

"pio_data.h" 

"pro_num.h" 

"pro_assoc.h" 

"pro_size.h" 

"assoc.h" 

"libnetwork.h" 

''net_stats.h" 

Declarations: 

vehlnelevant 

send_status_response_trans() 
send_status_in_f _ iirg_muUicast_group_zero() 


2.1.1.3.1.63.1  network_respond_to__query_trans 
This  routine  sends  a  transaction  response  to  a  status  query. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pkt 

DOinter  to  StatusQueryVariant 

p  data.h 

exercise 

ExerciselO 

basic.h 

orioinator 

pointer  to  SimulationAddress 

address.h 

tid 

T  ransactionidentifier 

address,  h 

1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

kinore 

int 

Standard 

pdu 

DataCollectionPDU 

p  data.h 

rsp 

pointer  to 

StatusResponseVariant 

p_data.h 

Function _ 

can  Ignore _ 

send  vehicle  status  trans 
send  exercise  status  trans 
send  simulation  status  trans 
send  status  response  trans 


Calls _ 

I  Where  Described 

_  Section  2.1.1  .S.l. 63.3 

Section  2.1.1 .3.1.71 .3 
Section  2.1 .1.3.1 .14.2 
Section  2. 1.1 .3. 1.59.2 
Section  2.1. 1.3.1. 63.7 


Table  2.1>68:  network_respond_to_query_trans  Information. 
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2.1.1.3.1.63.2  network_respond_to_query_pkt 
This  routine  sends  a  datagram  response  to  a  status  query. 


i  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Dkt 

pointer  to  StatusQuervVariant 

p  data.h 

exercise 

ExerciselD 

basic.h 

1  Calls  1 

1  Function  1 

Where  Described 

Section  2.1.1.3.1.63.3 

send  vehicle  status  in  f  ina 
multirast  arouD  zero 

Section  2.1.1.3.1.71.2 

send  vehicle  status 

Section  2.1.1.3.1.71.1 

send  exercise  status  pkt 

Section  2.1.1.3.1.14.1 

send  simulation  status  pkt 

Section  2.1.1.3.1.59.1 

Table  2.1-69:  network_respond_to_query_pkt  Information. 
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2.1.1.3.1.63.3  canjgnore 

The  status  query  unitRelation  field  allows  the  query  to  select  respondents  based  on  the 
organizational  units  they  simulate.  Each  receiver  of  the  query  must  determine  whether  it  is 
necessary  to  respond.  This  routine  determines  whether  Ae  invoking  process  is  within  the 
unit  relationship  speciBed  by  the  status  query  packet. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

Dkt 

pointer  to  StatusQuervVariant 

p  data.h 

exercise 

ExerciselD 

basic.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

ourlO 

reaister  pointer  to  VehiclelD 

basic.h 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

0 

int 

must  respond  to  the  status 
auerv 

-1 

int 

procedure  has  failed 

1 

int 

can  ianore  the  status  auerv 

I  Calls  I 

Function 

Where  Described 

network  aet  exercise  id 

Section  2.1.1.3.1.16.1 

network  aet  vehicle  id 

Section  2.1.1.3.1.22.1 

VEHICLE  IDS  EQUAL 

Sim  macros.h 

network  aet  simulator  tvoe 

Section  2.1.1.3.1.19.1 

network  aet  vehicle  force 

Section  2.1.1.3.1.17.1 

network  aet  vehicle  unit 

Section  2.1.1.3.1.20.1 

same  unit 

Section  2.1.1.3.1.63.4 

included  unit 

Section  2.1.1.3.1.63.5 

includina  unit 

Section  2.1.1.3.1.63.6 

Table  2.1*70:  canjgnore  Information. 
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2.1.1.3.1.63.4  same  unit 


This  routine  determines  if  the  invoking  process  is  in  the  same  organizational  unit  as  other. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

other 

Dointerto  OroanizationalUnit 

basic.h 

me 

pointer  to  OroanizationalUnit 

basic.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

op 

register  pointer  to 

Unitidentifier 

basic.h 

mp 

register  pointer  to 

Unitidentifier 

basic.h 

i 

register  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

FALSE 

int 

not  in  the  same  organizational 
unit  as  other 

TRUE 

int 

in  the  same  organziational  unit 
as  other 

Table  2.1-71:  same  unit  Information. 
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2.1.1.3.1.63.5  included  unit 


This  routine  detennines  whether  the  organizational  unit  of  the  invoking  process  is  included 
by  the  organizational  unit  of  other. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

other 

pointer  to  OraanizationatUnit 

basic,  h 

me 

pointer  to  OrpanizationalUnit 

basic,  h 

1  Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

op 

register  pointer  to 
umtldentifier 

basic,  h 

mp 

register  pointer  to 

Unitidentifier 

basic.h 

i 

reaister  int 

Standard 

last  valid  value 

register  int 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

FALSE 

int 

we  are  not  included  by  the 
oroanizational  unit  of  other 

TRUE 

int 

we  are  included  by  the 
oroanizational  unit  of  other 

Table  2.1-72:  included  unit  Information. 
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2.1.1.3.1.63.6  including_unit 

This  routine  deteimines  whether  the  organizational  unit  of  other  is  included  by  the 
organizational  unit  of  the  invoking  process. 


Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

other 

pointer  to  OraanizationalUnit 

basic.h 

me 

pointer  to  OraanizationalUnit 

basic,  h 

Internal  Variables 

Variable  1  Tyne 

Where  Typedef  Declared 

op 

register  pointer  to 

Unitidentifier 

basic.h 

mp 

register  pointer  to 

Unitidentifier 

basic.h 

1 

reaister  int 

Standard 

last  valid  value 

reaister  int 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

FALSE 

int 

includes  the  organizational 
unit  of  other. 

TRUE 

int 

does  not  include  the 
oraanizational  unit  of  other. 

Table  2.1-73:  including_unit  Information 
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2.1.1.3.1.63.7  send_status_response_trans 


This  routine  sends  a  Status  Response  PDU  as  a  transaction  response  to  a  Status  Query 
FDU  when  the  conditions  specified  in  the  Status  Query  PDU  are  not  met. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

result 

register  pointer  to 
StatusResponseVariant 

p_data.h 

oriainator 

pointer  to  SimulationAddress 

address.h 

tid 

T  ransactionidentif  ier 

address.h 

exercise 

ExerciselD 

basic.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Ddu 

DataCollectionPDU 

p  data.h 

r 

register  pointer  to 
StatusResponseVariant 

p_data.h 

Calls 

Function 

Where  Described 

AssocSendResponse 

See  MCC  CSCI  Section  2.20.1.4.2 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

PRO  DATA  STATUS  RESPONSE  SIZE 

p  size.h 

NOTE  SENT 

Called  Bv 

Function 

Where  Described 

network  respond  to  ouerv  trans 

Section  2.1.1.3.1.63.1 

Table  2.1>74:  send_status_response_trans  Information. 


2.1.1.3.1.64  targetDiseng.c 

(7simnet/release/src/vehicle/libsrc/libSendNet/targetDiseng.c) 

Code  in  this  Hie  is  not  compiled  in  the  Version  6.6  release. 

2.1.1.3.1.65  target  engag.c 

(ysininet7release/src/vehicIe/libsrc/libSendNet/target_engag.c) 

Code  in  this  file  is  not  compiled  in  the  Version  6.6  release. 
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2.1.1.3.1.66  thresh.c 

(ysimnet^elease/src/vehicle/libsrc/libSendNet/thresh.c) 

This  file  contains  the  routines  which  decide  when  to  send  out  vehicle  appearance  packets. 
The  vehicle  specific  code  may  substitute  for  the  routines  in  this  file.  If  substitutions  are 
made,  no  references  may  be  made  to  "thresh.c"  routines  in  order  to  prevent  duplicate 
reference  problems  with  the  linker. 

Includes: 

"send  loc.h" 

"pro_sim.h" 

"pro_size.h" 

”veh_type.h" 

"net/network.h" 

"Ubapp.h" 

"Ubkin.h" 

"UbhuU.h" 

''libmatrix.h" 

"net_stats.h" 

Declarations: 

prev_update 
thresholds 
v_pkt_verbose 
network_suppres  s_app 

2.1.1.3.1.66.1  v_pkt_verbose_mode 

This  routine  is  called  to  force  the  simulation  to  send  out  a  vehicle  appearance  packet  every 
tick  without  checking  the  RVA  algorithms  or  calling  network_^check_veh_app.  The 
routine  sets  the  variable  v _pkt_yerbose  equal  to  TRlfe.  “  -- 

2.1.1.3.1.66.2  network_stop_sending_app 

This  routine  sets  the  variable  network  suppress  app  equal  to  TRUE. 

2.1.1.3.1.66.3  network_restart_sending_app 

This  routine  is  used  for  debugging  purposes.  It  sets  the  variable  network  suppress  app 
equal  to  FALSE,  preventing  appearance  packets  from  being  sent  on  the  network. 
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2.1.1.3.1.66.4  network_check_veh_appearance 

This  routine  is  called  from  net  xmit().  The  routine  decides  whether  to  send  out  a  vehicle 
appearance  packet,  and  sends  the  packet,  if  necessary. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Ddu 

pointer  to  SimulationPDU 

p  sim.h 

internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

pkt 

pointer  to 

VehicleAppearanceVariant 

p_sim.h 

Calls 

Function 

Where  Described 

network  fill  hdr  send  sIm  pkt 

Section  2.1.1.3.1.42.5 

PRO  SIM  APPEARANCE  SIZE 

p  size.h 

AopearanceDlscrepancvExceedsThresholds 

Section  2.5.16.3.2 

timers  aet  current  tick 

Section  2.6  3.1. 1 

Table  2.1*75:  network_check_veh_appearance  Information. 
2.1.1.3.1.66.5  network_init_threshoIds 

This  routine  is  called  to  initialize  the  thresholds  used  to  determine  when  to  send  out  Vehicle 
Appearance  packets.  Note  that  these  are  only  initial  values;  they  will  be  overwritten  as 
soon  as  the  first  VAP  is  generated. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

thresh  file 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

Read  DiscrepancyThresholds 
(thresh  file.  &thresholds) 

int 

thresholds 

1  Calls  1 

Function 

Where  Described 

network  aet  vehicle  type 

Section  2.1.1.3.1.23.1 

fmat  kfent  init 

Section  2.6.2.13.1 

Table  2.1*76:  network  init  thresholds  Information. 
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2.1.1.3.1.67  tow_status.c 

(./simnet/release/src/vehicle/libsrc/libSendNet/tow_status.c) 


Includes: 

"sendjoc.h" 

"veh_appear.h 


tt 


2.1.1.3.1.67.1  network_tow_Iauncher_up 

This  routine  is  used  by  the  M2  to  indicate  that  the  TOW  launcher  is  up. 

2.1.1.3.1.67.2  network_tow_launcher_down 

This  routine  is  used  by  the  M2  to  indicate  that  the  TOW  launcher  is  down. 

2.1.1.3.1.68  use_activ.c 

(7simnet/release/src/vehicle/libsrc/libSendNei/use_activ.c) 


Includes: 

"ctype.h" 

"sendjoc.h" 

"veh_app_loc.h" 

"pro_sim.h" 

"pro_assoc.h" 

••Ubhull.h" 

"Ubkin.h" 

"Ubturret.h" 

"librepair.h" 

"libmain.h" 

"libcig.h" 

Defines:  DB_FILENAME_S1ZE 

2.1.1.3.1.68.1  format_db_filename 

This  routine  formats  the  database  filename  for  activation. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

name 

pointer  to  char 

Standard 

database 

pointer  to  char 

Standard 

version 

int 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

StrinalDB  FILENAME  SIZE1 

char 

Standard 

s 

pointer  to  char 

Standard 

Table  2.1-77;  format_db_filename  Information. 
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2.1.1.3.1.68.2  network_use_acti  vation 

This  routine  is  called  when  process_an_activate(),  located  in  libRcvNet,  gets  an  activate 
packet.  First,  the  activate  packet  is  saved  for  future  use.  Then,  information  from  the 
activate  packet  is  moved  into  the  vehicle  appearance  packet,  (^p _pkt.  Note  that  the  vehicle 
specific  code  processes  activation  packets  using  the  routine 
network  process_activation  parametersQ.  Note  that  ammo_init()  and 
fuel_init(J  are  called  after  the  BCOPY  of  init _pkt,  but  before  calling 
network_^process_activation_parameterr().  This  allows  vehicles  with  multiple 
configuraBons  to  know  what  they  are  simulating  before  determining  their  maximum  fuel 
and  ammunition  capabilities. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pkt 

pointer  to 

Activate  ReouestVariant 

p_sim.h 

oriQinator 

pointer  to  SimulationAddress 

address. h 

tid 

Transact  ionident  if  ier 

address.h 

1  Internal  variables  I 

Variable 

Tvoe 

Where  Typedef  Declared 

databasef231 

char 

Standard 

yaw 

REAL 

Sim  tvpes.h 

vap 

pointer  to 

VehicleAppearanceVariant 

p_sim.h 

1  Calls  1 

Function 

Where  Described 

ammo  init 

Section  2.2.5.1.1 

fuel  init 

Section  2.3.5.2.2 

format  db  filename 

Section  2.1.1.63.1.68.1 

cig  use  database  named 

network  process  activation  parameters 

hull  uninit 

Section  2.5.9. 1.2 

repair  uninit 

Section  2.5.4.19.2 

kinematics  pos  init 

Section  2.5.8.13.1 

turret  pos  init 

Section  2.5.5. 2.2 

send  activate  response 

Section  2.1. 1.3.1. 1.1 

activate  simulation 

Section  2.5.1. 1.3 

Table  2.1-78:  network  use  activation  Information. 
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2.1.1.3.1.69  veh_app  loc.h 

(7sin:inetA«Iease/src/vehicle/libsrc/libSen(iNet/veh_app_loc.h) 

This  file  contains  local  declarations  used  in  libSendNet. 

2.1.1.3.1.70  veh_impact.c 

(ysinmet/release/src/vehicle/libsrc/libSendNet/veh_iinpact.c) 


Includes; 

•■stdio.h" 

"sim_types.h" 

"siin_dfns.h" 

"sim_macros.h" 

"sendjoc.h" 

"pro_sim.h" 

"pro_size.h" 

"mun_type.h" 

"veh_app_loc.h" 

"siin_ammo.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"librva.h" 

"libmap.h" 

"basic.h" 


Defines:  CIG_SAYS_TURRET 

Declarations: 

null_vehicleID 

null_world_coordinates 
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2.1.1.3.1.70.1  network_send_vehicle_impact 


This  routine  sends  an  Impact  PDU  transaction  for  a  vehicle  impact. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

eventID 

EventID 

basic.h 

1  lulu  ll'l  1  1^^— — 

int 

Standard 

detonator  type 

Objectlype 

p  sim.h 

Quantitiv 

unsianed  int 

Standard 

rate 

unsioned  int 

Standard 

vehicle  struck 

pointer  to  VehicielD 

basic.h 

object  taa 

int 

Standard 

chord  start 

pointer  to  VehicieCoordinates 

basic.h 

chord  end 

pointer  to  VehicieCoordinates 

basic.h 

location 

WorldCoordinates 

basic.h 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

Ddu 

SimulationPDU 

p  sim.h 

pkt 

register  pointer  to 

ImpactVariant 

p_sim.h 

trajectory 

VehicieCoordinates 

basic.h 

1  Calls  1 

Function 

Where  Described 

fTtap  oet  network  type  from  ammo  entry 

Section  2.6.11.2.3 

vec  copy 

Section  2.6.2.59.1 

fvec  copy 

Section  2.6.2.26.1 

fvec  sub 

Section  2.6.2.29.1 

network  fill  hdr  sene  'im  trans 

Section  2.1.1.3.1.47.1 

PRO  SIM  IMPAC  ■ 

p  size.h 

Table  2.1-79:  network_send_vehicIe_impact  Information. 
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2.1.1.3.1.71  veh_status.c 

(7sinninet/release/src/vehicle/libsrc/libSendNet/veh_status.c) 


Includes: 

"send_loc.h" 

"veh_app_loc.h" 

"pro_assoc.h" 

"pro_data.h" 

"pro_size.h" 

"net_stats.h" 

Declarations: 

build_vehicle_status() 

2.1.1.3.1.71.1  send_vehicle_status 

This  routine  is  called  by  net_xmit()  or  process_query_pkt()  to  send  a  Vehicle  Status 
PDU  using  the  datagram  service.  It  calls  build_vehicle_status()  to  fill  in  the  packet. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

Ddu 

OataCollectionPDU 

p  data.h 

pkt 

pointer  to 

VehicleStatusVariant 

p_data.h 

1  Calls  1 

Function 

Where  Described 

build_ vehicle  status 

Section  2.1.1.3.1.71.4 

network  fill  hdr  send  dc  okt 

Section  2.1.1.3.1.42.6 

PRO  DATA  VEHICLE  STATUS  SIZE 

D  size.h 

Table  2.1-  80:  send_vehicle_status  Information. 
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2.1.1.3.1.71.2  send_vehicle_status_in_f _ ing_multicast_group_zero 

This  routine  sends  a  Vehicle  Status  PDU  transacdon  in  multicast  group  zero. 


1  Internal  Variables  1 

Variable 

Tvoe 

Where  Tvpedef  Declared 

pdu 

DataCollectionPDU 

p  data.h 

pkt 

pointer  to 

VehicleStatusVariant 

p_data.h 

Calls 

Function 

Where  Described 

build  vehicle  status 

Section  2.1.1.3.1.71.4 

fill  dcHdr 

Section  2.1.1.3.1.42.6 

AssocSendDataaram 

See  MCC  CSCI  Section  2.20.4.2.1 

netwofk  aet  net  handle 

Section  2.1.1.3.2.12.1 

PRO  DATA  VEHICLE  STATUS  SIZE 

p  size.h 

NOTE  SENT 

Table  2.1-81:  send_vehicle  status_in_f _ ing_multicast_group_zero 

niformation. 


2.1.1.3.1.71.3  send  vehicle  status  trans 


This  routine  sends  a  Vehicle  Status  PDU  as  a  response  to  a  Status  Query  transaction. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

oriainator 

pointer  to  SimulationAddress 

address.h 

tid 

T  ransactionidentifier 

address,  h 

exercise 

ExerciselD 

basic.h 

Internal  Variables 

Variable 

Tvoe 

Where  Tvpedef  Declared 

Pdu 

DataCollectionPDU 

p  data.h 

pkt 

pointer  to 

VehicleStatusVariant 

p_data.h 

Calls 

Function 

Where  Described 

build  vehicle  status 

Section  2.1.1.3.1.71.4 

fill  dcHdr 

Section  2.1.1.3.1.42.4 

AssocSendResponse 

See  MCC  CSCI  Section  2.20.1.4.2 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

PRO  DATA  VEHICLE  STATUS  SIZE 

p  size.h 

NOTE  SENT 

Table  2.1-82:  send  vehicle  status  trans  Information. 
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2.1.1.3.1.71.4  build  vehicle  status 


This  routine  fills  in  the  fields  of  a  Vehicle  Status  PDU.  This  routine  fills  in  the  vehicle 
independent  fields  and  calls  fill_vehicle_spec_status()  to  fill  in  the  vehicle  specific 
fields.  ~  ” 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pkt 

register  pointer  to 
VehicleStatusVariant 

p_data.h 

Calls 

Function 

Where  Described 

vehicle  aet  elaosed  km 

Section  2.3.2.3.4.4 

fill_vehicle_spec_status 

Section  2.2.7.1 

Section  2.3.7.1 

Section  2. 4. 6.1 

Table  2.1-83:  build_vehicle_status  Information. 
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2.1.1.3.2  libRcvNet 

(ysimnetA«lease/src/vehicle/libsrc/libRcvNet  [libRcvNet]) 

Routines  in  LibRcvNet  receive  and  process  various  types  of  SIMNET  data  packets. 

2.1.1.3.2.1  activate.c 

(ysimnet/release/src/vehicle/libsnc/libRcvNet/activate.c) 

Includes: 

"rcvjoc.h" 

"net_stats.h" 

"pto_sim.h" 

"pro_num.h" 

"pro_size.h" 

"pro_assoc.h" 

"address.h" 

"net/network.h" 

"nei/nettab.h" 

"assoc.h" 

2. 1.1. 3. 2. 1.1  process_activate_request 

This  routine  is  called  to  process  an  activate  request  PDU.  The  Activate  PDU  may  be 
received  either  from  the  network  or  from  the  simulation  console  (if  the  -p  option  was 
specified).  The  routine  calls  network_use_activation(),  located  in  libSendNet,  to  save 
the  different  parts  of  the  PDU  and  to  start  the  simulation. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

P 

pointer  to 

ActivateReauestVariant 

p_sim.h 

oriainator 

pointer  to  SimulationAddress 

address.h 

tid 

T  ransactionidentifier 

address.h 

exercise 

ExerciselD 

basic.h 

1  internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

old  exercise 

ExerciselD 

basic.h 

handle 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

network  aet  exercise  id 

Section  2.1.1.3.1.16.1 

AssocUnsubscribe 

See  MCC  CSCI  Section  2.20.1 .1 .2 

network  set  exercise  id 

Section  2.1.1.3.1.49.1 

AssocSubscribe 

See  MCC  CSCI  Section  2.20.1.1.1 

veh  set  force 

Section  2.6.10.6.2 

filter  set  force 

Section  2.5.14.6.1 

filter  set  location 

Section  2.5.14 

network  use  activation 

Section  2.1.1.3.1.68.2 

Table  2.1>84:  process_activate_request  Information. 
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2.1.1.3.2.2  alert_status.c 

(ysirnnet/rclease/src/vehicle/libsrc/libRcvNet/alert_status.c) 

Code  in  this  file  is  not  used  in  the  Version  6.6  release. 

2.1.1.3.2.3  collision.c 

(7simnet/ielease/six^vehicle/libsrc/libRcvNet/colIision.c) 

Includes: 

"mass_stdc.h" 

”sim_types.h” 

"dgi_stdg.h" 

"sim_cig_if.h" 

"ctype.h" 

"Ubrva.h" 

"rcv_loc.h" 

"net_stats.h" 

"pro_sim.h" 

"pro_assoc.h" 

"bigwheel.h" 

"libhulLh" 

Declarations:  network_debug  =  FALSE 

2. 1.1. 3. 2. 3.1  process_conision 

This  routine  processes  a  Collision  PDU.  This  routine  makes  a  call  to 
network_send_colIision_response()  to  acknowledge  receipt  of  the  packet.  A  call  is 
also  made  to  c6ilision_check_veh_coU_at(),  located  in  libbigwh,  to  determine  the 
direction  from  which  tlie  vehicle  was  hit.  ~ 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

P 

register  pointer  to 
CollisionVariant 

p_sim.h 

oriainator 

pointer  to  SimulationAddress 

address. h 

tid 

T  ransactionidentifier 

address.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

hash  id 

int 

Standard 

mv  vehicle  id 

pointer  to  VehiclelD 

basic.h 

rva  find  hash  entrvO 

extern  int 

Standard 

1  Calls  1 

Function 

Where  Described 

rva  find  hash  entry 

Section  2.5.12.11.11 

network  aet  vehicle  id 

Section  2.1.1.3.1.22.1 

network  send  collision  response 

Section  2.1.1 .3. 1.7.1 

collision  check  veh  coll  at 

Section  2.5.10.6.1 

Table  2.1-85:  process_collision  Information. 
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2.1.1.3.2.4  deactivate.c 

(ysimnetAelease/src/vehicle/libsrcAibRcvNet/deactivate.c) 

Includes: 

"ctype.h" 

"rcvjoc.h" 

"net_stats.h" 

"pro_sim.h" 

"pn>_assoc.h" 

2. 1.1. 3. 2. 4.1  process_deacti  vate_me 

This  routine  processes  a  Deactivate  PDU  that  is  intended  to  deactivate  the  vehicle.  The 
routine  makes  a  call  to  libSendNet  to  acknowledge  receipt  with  a  Deactivate  Response  PDU 
and  initiates  the  deactivation. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

pkt 

pointer  to 

OeactivateReouestVariant 

p_sim.h 

oriainator 

pointer  to  SimulationAddress 

address.h 

tid 

Transact  ionidentifier 

address.h 

1  Calls  1 

Function 

Where  Described 

NOTE  FOR  US 

network  send  deactivate  response 

Section  2.1. 1.3.1. 9.1 

beep 

Section  2.6.4.1.1 

deactivate  simulation 

Section  2.5.1. 1.4 

Table  2.1*86:  process_deactivate_me  Information. 


2. 1.1. 3. 2. 4. 2  process_deacti vate_other 


This  routine  processes  a  Deactivate  PDU  that  informs  the  invoking  process  of  another 
vehicle's  deactivation.  The  routine  makes  a  call  to  librva  in  order  to  cease  dead  reckoning 
and  displaying  that  vehicle. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pkt 

pointer  to 

DeactivateReouestVariant 

p_sim.h 

Calls 

Function 

Where  Described 

rva  foraet  about  other  vehicle 

Section  2.5.12 

Table  2.1-87:  process_deactivate_other  Information. 
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2.1.1.3.2.5  fire.c 

(ysimnet/releas^src/vehicle/libsrcAibRcvNet/fire.c) 

Includes; 

"rcv_loc.h" 

"net_stats.h" 

"pro_sim.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubkin.h" 

"bigwheelh" 

"Ubhull.h" 

"libin^s.h" 

"Ubrva.h" 

"libveh.h" 


Declarations:  remote_vehiclesD 

2. 1.1. 3. 2. 5.1  process_fire 


This  routine  processes  a  Fire  PDU  that  notifies  the  invoking  process  that  a  shell  or  missile 
was  fired.  The  routine  determines  whether  it  is  necessary  for  the  vehicle  to  display  any 
effects  (such  as  a  muzzle  Hash)  or  make  any  sounds. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

£ 

pointer  to  FireVariant 

p  sim.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

map  index 

int 

Standard 

REAL 

Sim  types.h 

vec 

pointer  to  REAL 

Sim  types.h 

cia  aet  current  range  sqrd 

extern  REAL 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

kinematics  get  o  to  h 

Section  2.5.8.2.4 

kinematics  range  squared 

Section  2.5.8.10.1 

cig  get  current  range  sgrd 

Section  2.5.12.21.1 

mao  get  ammo  entry  from  network  type 

Section  2.6.11.2.1 

NOTE  FOR  US 

impacts  queue  effect 

Section  2.5.15.1.3 

Table  2.1-88  process_fire  Information. 

2.1.1.3.2.6  fire_probe.c 

(ysimnetAelease/src/vehicleAibsrc/libRcvNet/fire_probe.c) 

Code  in  this  file  is  not  used  in  the  Version  6.6  release. 
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2.1.1.3.2.7  idiot_check.c 

(ysininetAelease/srcA'ehicle/libsrc/libRcvNetAdiot_check.c) 

Code  in  this  file  is  not  used  in  the  Version  6.6  release. 

2.1.1.3.2.8  impact.c 

(ysininetAelease/src/vehicle/libsrc/libRcvNet/impact.c) 


Includes; 

"rcv_loc.h" 

"net_stats.h" 

"pro_sim.h" 

"pro_assoc.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

”sim_cig_if.h" 


"Ubkin.h" 

"libhuU.h" 

"librva.h" 

"libfail.h" 


"libimps.h" 

"libsound.h" 

"Ubveh.h" 


Declarations: 

iemote_vehiclesD 

impact_debug 

null_world_coordinates 

2. 1.1. 3. 2. 8.1  process_hit_me 

This  routine  processes  an  Impact  PDU  that  notifies  the  invoking  process  of  a  shell  or 
missile  impact  with  the  vehicle.  A  call  is  made  to  libSendNet  to  acknowledge  receipt  of  the 
packet,  and  a  call  is  made  to  veh_impact_me()  in  order  to  assess  damages. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

P 

pointer  to  ImpactVariant 

p  sim.h 

oriainator 

pointer  to  SimulationAddress 

address.h 

tid 

T  ransaction  Identifier 

address.h 

Calls 

Function 

Where  Described 

veh  impact  me 

Section  2.1.1. 3.2.8  3 

network  send  impact  response 

Section  2.1.1.3.1.26.1 

Table  2.1*89:  process_hit_ine  Information. 
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2. 1.1. 3. 2. 8. 2  process_hit_other 

This  routine  processes  an  Impact  PDU  that  notifies  the  invoking  process  of  an  impact  with 
an  object  other  than  the  vehicle  itself.  A  determination  is  made  as  to  whether  the  impact 
was  with  another  vehicle  or  with  the  ground,  or  if  it  went  out  of  the  range  of  the  terrain 
database.  The  appropriate  processing  routine  is  then  called. 

_ Parameters _  _ 


_ Calls _ 

Table  2.1-90:  process_hit_other  Information. 

2.1. 1.3. 2. 8. 3  veh_impact_me 

This  routine  assesses  damages  due  to  an  impact  with  the  vehicle.  The  ammo  type  and 
failure  are  determined,  and  the  appropriate  effects  are  shown. 

Parameters 


Calls 


Table  2.1-91:  vehjmpact_me  Information. 


Where  Described 

Section  2.6.11 .2.1 
Section  2.5.15.1.3 
Section  2.2.4.1.9 
Section  2.3.4.1.3 


Function 


et  ammo  entry  from  network  type 


imoacts  Queue  effect 


failure  check  cat  kill 


Where  Tvpedef  Declared 

p_sim.h 


Where  Described 

Section  2.1.1.3.2.8.4 
Section  2.1.1.3.2.8.5 
Section  2.1.1.3.1.33 


Function 


veh  impact  other 


round  impact 


non  impact 


P 


Where  Tvpedef  Declared 

p_sim.h 
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2. 1.1. 3. 2. 8. 4  veh_impact_other 


This  routine  deteimines  which  sounds  to  make  and  which  visual  effects  to  show  when  an 
impact  is  made  with  another  vehicle. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

P 

register  pointer  to 

ImpactVariant 

p_sim.h 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

ammo  type 

int 

Standard 

double 

Standard 

1  Calls  1 

Function 

Where  Described 

map  aet  ammo  entry  from  network  type 

Section  2.6.11.2.1 

kinematics  ranae  squared 

Section  2.5.8.10.1 

impacts  queue  effect 

Section  2.5.15.1.3 

Table  2.1-92:  vehJmpact_other  Information. 


2. 1.1. 3. 2. 8. 5  ground_impact 

This  routine  deteimines  the  sounds  to  make  and  the  visual  effects  to  show  when  an  impact 
IS  made  with  the  ground. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

P 

register  pointer  to 

ImpactVariant 

p_sim.h 

1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

ammo  type 

int 

Standard 

double 

Standard 

1  Calls  1 

Function 

Where  Described 

mak  qet  ammo  entry  from  network  type 

Section  2.6.11.2.1 

kinematics  range  squared 

Section  2.5.8.10.1 

impacts  queue  effect 

Section  2.5.15.1.3 

Table  2.1-93:  ground_impact  Information. 
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2.1. 1.3. 2. 9  indir_fire.c 

(./simnet/release/src/vehicIe/libsrc/libRcvNei/in'dir_fire.c) 

Includes:  Declarations: 

"stdio.h"  got_diag_eff 

"rcvjoc.h"  ind_fire_debug 

"net_stats.h" 

"pro_sim.h" 

"mun_type.h" 

"obj_type.h" 

"sim_macros.h" 

"mass_stdc.h" 

^  "dgi_stdg.h" 

"sim_cig_if.h" 

"libkin.h" 

"bigwheel.h" 

"libhull.h" 

"libiva.h" 

"libfail.h" 

"libimps.h" 

"libcig.h" 

"libsound.h" 

2. 1.1. 3. 2. 9.1  processjndirect_flre 

This  routine  processes  an  Indirect  Fire  PDU  that  notifies  the  invoking  process  of  the 
impacts  due  to  indirect  fu^.  The  routine  calculates  the  range  of  the  impacts,  assesses  any 
damages,  and  determines  whether  it  is  necessary  for  the  vehicle  to  display  effects  or  make 
sounds. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

^ _ 

pointer  to  IndirectFire Variant 

p  sim.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

register  int 

Standard 

delay 

register  int 

Standard 

ammo  type 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

map  aet  ammo  entry  trom  network  type 

Section  2.6.11.2.1 

ciQ  aet  current  ranae  sard 

Section  2.5.12.21.1 

kinematics  ranae  sauared 

Section  2.5.8.10.1 

cla  aet  current  ranae  sard 

Section  2.5.12.21.1 

lailure_checkjndirjire_damages 

Section  2.3.4.1.10 

Section  2.3.4. 1.4 

impacts  oueue  effect 

Section  2.5.15.1.3 

Tabic  2.1-94;  procc.ssjndlrcct^firc  Infurmution, 
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2.1.1.3.2.10  laser_range.c 

(./simnet/release/src/vehicle/libsrc/libRcvNet/laser_range.c) 

Code  in  this  file  is  a  stub  for  files  that  do  not  recognize  laser  packets. 

2.1.1.3.2.11  markers.c 

(./simnet/release/src/vehicle/libsrQlibRcvNel/markers.c) 


Includes: 

"rcvjoc.h" 

"net_stats.h" 

"pro_sim.h" 

"sim_macros.h 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libhull.h" 

"Ubkin.h" 

"librva.h" 


tt 


2.1.1.3.2.11.1  process_markers 

This  routine  processes  a  Marker  PDU.  Minefield  markers  are  processed  by  librva  as  static 
vehicles. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

nr 

register  pointer  to 

MarkerVariant 

p_sim.h 

1  Calls  1 

Function 

Where  Described 

NOTE  FOR  US 

rva  process  markers 

Section  2.5.12.13.3 

Table  2.1-95:  process_inarkers  Information. 
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2.1.1.3.2.12  network  init.c 

(7simnet/release/src/vehicle/libsrc/libRcvNet/network_init.c) 


Includes; 

"rcvjoc.h" 

"itab.h" 

"ermo.h" 

"net/network.h" 

"pro_assoc.h" 

"pro_sim.h" 

"pro_num.h" 

"assoc.h" 

"p2p.h" 


Dcfincst 

NETWORK_DEVICE_NAME_SIZE 

ASSOC_DEF_FILE 

flTfltlOTlS* 

network_device_name[NETWORK_DEVICE_NAME_SIZE] 

layer_to_use 

assoc_net_handle 

2.1.1.3.2.12.1  network_get_net_handle 

The  libnetif  module  supports  multiple  networks.  This  routine  obtains  a  network  handle, 
which  is  a  low  integer  referring  to  Ae  connection  to  a  particular  network. 


1  Return  Values  1 

Return  Value 

Meaning 

assoc  net  handle 

ini 

the  network  handle 

Table  2.1-96:  network_get_net_handIe  Information. 
2.1.1.3.2.12.2  network_set_net_layer 


This  routine  sets  up  the  network  to  use  either  the  association  or  point  to  point  layer. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

layer 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

0 

int 

indication  of  success 

Table  2.1-97:  network_set_net_layer  Information. 
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2.1.1.3.2.12.3  network_init 

This  routine  obtains  the  connection  to  the  network  using  either  the  association  or  point  to 
point  layer  and  sets  the  parameters  for  the  network.  Timestamping  is  disabled  and  the 
clock  is  reset  to  zero,  llie  routine  also  obtains  the  simulation  address  and  determines  the 
vehicle  ID. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared  1 

sim_address 

SimulationAddress 

vid 

VehiclelD 

basic.h  I 

1  Errors  I 

Error 

Reason  for  Error 

Error  disablina  timestampina 

proUems  disabling  timestamping 

Error  initting  net  timer 

problems  resetting  clock  to  zero 

1  Calls  1 

Function 

Where  Described 

set  process  pkt  fn 

Section  2.1.1.3.2.18.1 

PointToPointOpen 

Section  2.1.1. 2.2.1. 1 

AssocError 

See  MCC  CSCI  Section  2.20.1.10.1 

AssocOpen 

See  MCC  CSCI  Section  2.20.1 .5.1 

net  stamp  disable 

See  MCC  CSCI  Section  2.20.2.12.2 

net  init  time 

See  MCC  CSCI  Section  2.20.2.8.4 

AssocSubscribe 

See  MCC  CSCI  Section  2.20.1.1.1 

assoc  net  handle 

AssocGetSimAddress 

See  MCC  CSCI  Section  2.20.1.9.1 

network  set  vehicle  id 

Section  2.1.1.3.1.55.1 

Table  2.1*98:  network  init  Information. 


2.1.1.3.2.12.4  network  set  network  device 


This  routine  sets  the  network  device  name  used  for  the  network  connection  to  device. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

device 

pointer  to  char 

Standard 

Table  2.1*99:  network  set  network  device  Information. 
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2.1.1.3.2.12.5  network_get_net  work_device 

This  routine  returns  the  network  device  name  for  a  network  connection. 


1  Return  Values  1 

Return  Value 

Meaning 

network_device_name 

pointer  to  char 

the  name  of  the  network 
device 

Table  2.1>100:  network_get_network_device  Information. 

2.1.1.3.2.13  network  test.c 

(ysimnet/rclease/src/vehicle/libsrc/libRcvNet/network_test.c) 

Code  in  this  file  is  not  compiled  in  the  Version  6.6  release. 

2.1.1.3.2.14  not_open_net.c 

(ysirnnet/rel^e/src/vehicle/libsrc/libRcvNet/not_open_net.c) 

Includes:  "rcv_loc.h" 

2.1.1.3.2.14.1  net  work_dont_really_open_up_et  hernet 

This  routine  sets  the  variable,  using  ethernet,  to  FALSE.  This  routine  is  used  during 
debugging  in  order  to  run  the  simulator  without  connecting  to  the  network. 

2.1.1.3.2.15  open_net.c 

(./simnet/release/src/vehicIe/libsrc/libRcvNet/open_net.c) 

Includes:  "rcv_loc.h" 

2.1.1.3.2.15.1  network_really_open_up_ethernet 

This  routine  sets  the  variable,  using  ethernet,  to  TRUE. 
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2.1.1.3.2.16  print_stats.c 

(ysininS/release/src/vehicle/libsrc/libRcvNet/print_stats.c) 


Includes: 

"rcvjoc.h" 

"net_stats.h" 

”pro_sim.h" 

"pro_data.h" 

"pio_mgmt.h" 


2.1.1.3.2.16.1  net  work_prin  t_sta  tistics 

This  routine  prints  statistics  about  the  number  and  types  of  packets  sent  on  the  network.  It 
prints  the  packets  received,  the  packets  for  the  invoking  process,  and  the  packets  sent  for 
the  Simulation  Packet  types,  Data  Analysis  Packet  types  and  Management  Packet  types. 


1  Calls  1 

Function 

Where  Described 

timers  aet  current  tick 

Section  2.6.3. 1.1 

Table  2.1>101:  network_print_statistics  Information. 

2.1.1.3.2.17  print_vimp.c 

(./simnet/release/src/vehicle/libsix^bRcvNet/print_vimp.c) 

Code  in  this  file  is  not  compiled  in  the  Version  6.6  release. 

2.1.1.3.2.18  proc_a  pkt.c 

(./simnet^lease/src/vehicle/libsrc/libRcvNet/proc_a_pkt.c) 


Includes: 

"stdio.h’' 

"bbd.h" 

"rcvjoc.h" 

"net_stats.h" 

"pro_sim.h" 

"pro_mgmt.h" 

"pro_data.h" 

"pro_stlth.h" 

"pro_assoc.h" 

"assoc.h" 

"veh_type.h" 

"p_faad.h" 

"p_num.h" 

E)eclarations: 

process  pkt_fn() 
keyboardlrccOTStitute 

This  file  contains  routines  which  sort  the  packets  received  from  the  network  and  call  the 
appropriate  modules  of  vehicles  code  for  processing.  First  the  packet  is  assigned  to  a 
major  category:  either  Management  Datagram,  Data  Collection  Datagram,  Simulation 


99 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


Datagram,  Simulation  Transaction,  or  Data  Collection  Transaction.  Each  of  the  major 
categories  distributes  the  packet  to  a  routine  contained  within  libRcvNet  which  then  passes 
the  packet  to  the  appropriate  module  for  processing.  For  example,  process_a  packet() 
assigns  a  Marker  PDU  to  the  routine  do_protocol_on_sim_packet(),  locaTeJ  in  this 
tile.  do_protocoI  on  sim_packet()  calls  the  routing process_markers(),  located  in 
the  libRcvNet  file  ’’mailcers.c".  process_niarkers()  then  calls 
rva  process  markersO,  located  in  librva,  which  processes  the  information  from  the 
Marker  PDUr 


2.1.1.3.2.18.1  set_process_pkt_fn 

This  routine  sets  the  association  layer  process  packet  function  to  fn.  The  default  is 
AssocReceivePDU. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

fn 

function  which  returns  a 
pointer  to  int 

Standard 

Table  2.1>102:  set_process_pkt_fn  Information. 

2.1.1.3.2.18.2  do_protocol_on_mgmt_packet 
This  routine  is  not  used  in  the  version  6.6  release. 

2.1.1.3.2.18.3  do_protocol_on_data_analysis_packet 

This  routine  processes  the  statusQueryPDUKind  and  the  laserRangePDUKind;  other  data 
analysis  datagrams  are  ignored. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pkt 

pointer  to  DataCollectionPDU 

p  data.h 

exercise 

ExerciselD 

basic.h 

Calls 

Function 

Where  Described 

NOTE  RECEIVED 

process  status  query 

Section  2.1.1.3.2.34.1 

process  laser  ranqe 

Section  2.1. 1.3.2 

Table  2.1>103:  do_protocol_on_data_analysis_packet  Information. 
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2.1.1.3.2.18.4  do_protocoI_on_siin_packet 

This  routine  processes  the: 

deactivateRequestPDUKind 

vehicleAppeaiancePDUKind 

radiatePDUKind 

firePDUKind 

impactPDUKind 

indirectFiiePDUKind 

serviceRequestPDUKind 

resupplyOfferPDUKind 

resupplyReceivedPDUKind 

icsupplyCancelPDUKind 

markerPDUKind. 


All  other  simulation  datagrams  are  ignored. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

pkt 

pointer  to  SimulationPDU 

p sim.h 

1  Calls  1 

Function 

Where  Described 

NOTE  RECEIVED 

process  deactivate  other 

Section  2.1.1.3.2.4.2 

process  update 

Section  2.1.1.3.2.37.1 

process  radiate 

process  fire 

Section  2.1.1.3.2.5.1 

process  hit  other 

Section  2.1.1.3.2.8.2 

process  indirect  fire 

Section  2. 1.1. 3. 2.9.1 

process  service  request 

Section  2.1.1.3.2.32.1 

process  resupply  offer 

Section  2.1.1.3.2.30.1 

process  resupply  received 

Section  2.1.1.3.2.31.1 

process  resupply  cancel 

Section  2.1.1.3.2.29.1 

process  markers 

Section  2.1.1.3.2.11.1 

Table  2.1-104;  do_protocoI_on_sim_packet  Information. 
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2.1.1.3.2.18.5  process_sim_transaction 
This  routine  processes  the: 

deactivateRequestPDUKind  if  the  simulator  is  in  simulation  state 
activateRequestPDUKind 

collisionPDUKind  if  the  simulator  is  in  simulation  state 
impactPDUKind  if  the  simulator  is  in  simulation  state 
lepairRequestPDUKind  if  the  simulate'  is  in  simulation  state. 


All  other  simulation  transactions  are  ignored. 


Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pkt 

pointer  to  SimulationPOU 

P  sim.h 

oriainator 

pointer  to  SimulationAddress 

address.h 

transID 

T  ransactionidentif  ier 

address.h 

Calls 

Function 

Where  Described 

NOTE  RECEIVED 

Sim  state  simulatinq 

Section  2.5.1.1.11 

process  deactivate  me 

Section  2.1 .1.3. 2.4.1 

process  activate  reouest 

Section  2.1.1. 3.2.1. 1 

process  coliision 

Section  2.1.1.3.2.3.1 

process  hit  me 

Section  2.1.1.3.2.8.1 

process  repair 

Section  2.1.1.3.2.28.1 

Table  2.1*105:  process_sim_transaction  Information. 


2.1.1.3.2.18.6  process_dc_t  ransaction 


This  roudne  processes  the  statusQueryPDUKind;  all  other  data  analysis  transactions  are 
ignored. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pkt 

pointer  to  DataCollectionPDU 

p  data.h 

oriainator 

pointer  to  SimulationAddress 

address.h 

tid 

T  ransactionidentif  ier 

address.h 

exercise 

Exercise  ID 

basic.h 

Calls 

Function 

Where  Described 

NOTE  RECEIVED 

process  query  me 

Section  2.1.1.3.2.34.2 

Table  2.1*106:  process_dc_transaction  Information. 
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2.1.1.3.2.18.7  reconst  itute_f  roni_key  board 

This  routine  sets  the  variable  keyboard  reconstitute  equal  to  1,  signalling 
process_a_packetO  to  act  as  if  it  just  received  an  Activate  Packet.  It  is  used  for 
debugging  purposes. 

2.1.1.3.2.18.8  process_a_packet 


This  routine  assigns  each  packet  to  a  category  based  upon  its  protocol  number.  Once  the 
packet  is  assigned,  the  routine  then  calls  ^e  appropriate  processing  routines. 


Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

data 

pointer  to  char 

Standard 

len 

int 

Standard 

group 

MulticastGroupID 

p  assoc,  h 

protocol 

AssociationUserProtocol 

p  assoc,  h 

primitive 

long  int 

Standard 

originator 

SimulationAddress 

address.h 

respondent 

SimulationAddress 

address. h 

transID 

T  ransactionldentifier 

address.h 

1  Return  Values  1 

Return  Value 

Meaning 

TRUE 

BOOLEAN 

procedure  was  successful 

FALSE 

BOOLEAN 

not  using  ethernet,  do  not 
have  current  protocol  version, 
or  the  process  packet  function 
does  not  return  0 

1  Calls  1 

Function 

Where  Described 

reconstitute_vehicle 

Section  2.2.1.1.10 

Section  2.3.1.1.12 

Section  2.4.1.1.10 

network  get  net  handle 

Section  2.1.1.3.2.12.1 

process  sim  transaction 

Section  2.1.1.3.2.18.5 

process  pkt  fn 

Section  2. 1.1. 3.2 

Sim  state  simulating 

Section  2.5.1.1.11 

do  protocol  on  sim  packet 

Section  2.1.1.3.2.18.4 

process  dc  transaction 

Section  2.1.1.3.2.18.6 

do  protocol  on  data  analysis  packet 

Section  2.1.1.3.2.18.3 

do  protocol  on  mgmt  packet 

Section  2.1.1.3.2.18.2 

do  protocol  on  stealth  packet 

Section  2.1. 1.3.2 

do  protocol  on  faad  packet 

Section  2.1. 1.3.2 

Table  2.1>107:  process_a_packet  Information. 
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2.1.1.3.2.19  prot_faad.c 

(ysininet/rclease/src/vehicle/libsrc/libRcvNet/prot_faad.c) 

This  file  is  a  stub  for  files  that  do  not  recognize  FAAD  packets. 

2.1.1.3.2.20  proMvis.c 

(./simnetAelease/src/vehicle/libsrc/libRcvNet/prot_ivis.c) 

This  file  is  a  stub  for  files  that  do  not  recognize  FVIS  packets. 

2.1.1.3.2.21  proMaser.c 

(ysimnetAelease/src/vehicle/libsrc/libRcvNet/prot_laser.c) 

This  file  is  a  stub  for  files  that  do  not  recognize  Laser  Effects  packets. 

2.1.1.3.2.22  prot_stealth.c 

(./simnet/release/src/vehicle/libsrc/libRcvNet/prot_stealth.c) 

This  file  is  a  stub  for  vehicles  that  do  not  recognize  Stealth  packets.  It  should  be  linked  in 

by  only  these  vehicles  and  should  NEVER  be  called. 

2.1.1.3.2.23  radiate.c 

(./simnet/release/src/vehicle/libsrc/libRcvNeVradiate.c) 

This  file  is  a  stub  for  files  that  do  not  recognize  Radiate  packets. 

2.1.1.3.2.24  rad_state.c 

(ysiiraiet/release/src/vehicle/libsrc/libRcvNet/rad_state.c) 

Includes: 

"rcvjoc.h" 

"net_stats.h" 

"libnetwork.h" 

"pro_sim.h" 

"pro_assoc.h" 

"p_num.h" 

"p_faad.h" 


2.1.1.3.2.24.1  process_radiating_state 

This  routine  processes  Radiating  State  PDUs  using  the  datagram  service. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

P 

register  pointer  to 
RadiatinqStateVariant 

Calls 

Function 

Where  Described 

NOTE  FOR  US 

controls  radar  state 

Section  2.2.2 

Table  2.1>108:  process_radiating_state  Information. 
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2.x. 1.3.2.25  rcv_loc.c 

(7sirnnet/release/src/vehicle/libsrc/libRcvNet/rcv_lcx:.c) 


Includes: 

"rcvjoc.h" 

"net_stats.h" 

Declarations; 

using_etlaemet  =  TRUE 
net_handle 

packets_received[maxProtocolFamily+l][maxPacketsPerFamily] 
packets_for_us[maxProtocolFamily+ 1  ]  [maxPacketsPerFamily] 

2.1.1.3.2.26  rcvjoc.h 

(7simnetAclease/src/vehicle/libsrc/libRcvNet/rcv_loc.h) 

2.1.1.3.2.27  really.c 

(7sininet/release/src/vehicle/libsrc/libRcvNet/really.c) 

Includes:  "rcvjoc.h" 

2.1.1.3.2.27.1  network_can  J_really_use_network 

This  routine  returns  the  value  of  the  using  ethernet  flag,  which  determines  whether  the 
network  can  be  used. 


1  Return  Values  I 

Return  Value 

Meaning 

using.ethernet 

int 

if  using_ethernet  is  TRUE, 
the  network  can  be  used; 
if  using_ethernei  is  FALSE, 
the  network  cannot  be  used 

Table  2.1-109:  network_canJ_reaIly_use_network  Information. 
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2.1.1.3.2.28  repair.c 

(./sinmet/rclease/src/vehicle/libsrc/libRcvNetAepair.c) 


Includes: 

"rcvjoc.h" 

"net_stats.h" 

"libnetwork.h" 

"pro_assoc.h" 


2.1.1.3.2.28.1  process_repair 
This  routine  processes  a  Repair  Request  PDU. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

P 

pointer  to 

RepairRequestVariant 

p_sim.h 

originator 

pointer  to  SimulationAddress 

address. h 

tid 

T  ransactionidentifier 

address. h 

Calls 

Function 

Where  Described 

NOTE  FOR  US 

repair  request 

Section  2.3.4.2.1 

Table  2.1-1 10:  process_repair  Information. 
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2.1.1.3.2.29  resupp_canc.c 

(./simnet^lease/src/vehic!e/libsrc/libRcvNe!/resupp_canc.c) 

Includes: 

"rcv_loc.h" 

"net_stats.h" 

"pro_sim.h" 

2.1.1.3.2.29.1  p  rocess_resu  pply_cancel 


This  routine  processes  Resupply  Cancel  PDUs. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

P 

pointer  to 

ResupplyCancelVariant 

p_sim.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

my  id 

pointer  to  VehiclelD 

basic. h 

1  Calls  1 

Function 

Where  Described 

network  oet  vehicle  id 

Section  2.1.1.3.1.22.1 

VEHICLE  IDS  EQUAL 

Sim  macros.h 

NOTE  FOR  US 

resupply  offer  canceled 

Section  2.2.5.3.32 

resupply  request  canceled 

Section  2.3.5.3.33 

Table  2.1-111:  process_resupply_canceI  Information. 
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2.1.1.3.2.30  resupp_offer.c 

(./simnet/rclease/src/vehicle/Iibsrc/libRcvNet/rcsupp_offer.c) 


Includes: 

"rcvjoc.h" 

"net_stats.h" 

"pro_sim.h" 

2.1.1.3.2.30.1  process_resupply_offer 
This  routine  processes  Resupply  Offer  PDUs. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

£ 

DOinter  to  ResuppivVariant 

p  sim.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

mv  id 

pointer  to  VehiclelD 

basic,  h 

1  Calls  1 

Function 

Where  Described 

network  oet  vehicle  id 

Section  2.1.1.3.1.22.1 

VEHICLE  IDS  EQUAL 

Sim  macros.h 

NOTE  FOR  US 

resuDDiv  offer  oacket 

Section  2.2.5.3.12 

Table  2.1-112:  process_resupply_offer  Information. 
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2.1.1.3.2.31  resupp_recvd.c 

(7sininet^lease/sic/vehicle/libsrc/libRcvNet/rcsupp_recvd.c) 

Includes: 

"rcvjoc.h" 

"net_stats.h" 

"pro_sim.h" 

2.1.1.3.2.31.1  process_resupply_received 
This  routine  processes  Resupply  Received  PDUs. 

Parameters 

Variant 


Where  Tvpedet  Declared 

D  sim.h 


Parameter 


inter  to  Resu 


Internal  Variables 


Variable _ Type _ Where  Tvpedef  Declared 

myid_ pointer  to  VehiclelD_ basic.h 


Calls 

Function 

Where  Described 

network  aet  yehicle  id 

Section  2.1.1.3.1.22.1 

VEHICLE  IDS  EOUAL 

Sim  macros.h 

NOTE  FOR  US _ 

resupply  thank  you  packet _ Section  2.2.5.3.13 


Table  2.1>113:  process_resupply_received  Information. 
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I 

i 


2.1.1.3.2.32  service_req.c 

(7siinnet;A«lease/src/vehicle/Iibsrc/libRcvNet/service_req.c) 


Includes: 

"rcvjoc.h" 

"net_stats,h" 

"pro_sim.h" 


2.1.1.3.2.32.1  process_service_request 
This  routine  processes  Service  Request  PDUs. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

Ifi _ _ _ 

pointer  to  ResuppIvVariant 

p  sim.h 

1  Internal  Variables  1 

1  Variable 

Where  Typedef  Declared 

|my_id 

pointer  to  VehiclelD 

basic,  h 

1  Calls  1 

Function 

Where  Described 

network  aet  vehicle  id 

Section  2.1.1.3.1.22.1 

VEHICLE  IDS  EQUAL 

Sim  macros.h 

NOTE  FOR  US 

resuDDiv  feed  me  oacket 

Section  2.2.5.3.14 

Table  2.1-114:  process_service_request  Information. 

2.1.1.3.2.33  show  effect. c 

(./simnet^lease/src/vehicle/libsrc/libRcvNet/show_effectc) 

This  file  is  not  used  in  the  Version  6.6  release. 
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2.1.1.3.2.34  status  query.c 

(ysimnet^lease/src/vehicleAibsic/libRcvNei/status_query.c) 


Includes: 

"rcvjoc.h" 

"net_stats.h" 

"pro_data.h" 

"pro_assoc.h" 

"Ubnetwork.h" 


2.1.1.3.2.34.1  process_status_query 

This  routine  processes  Status  Query  PDUs  by  calling  libSendNet  to  respond  with  the 
appropriate  Status  PDU  using  Ae  datagram  service. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

pkt 

pointer  to  StatusQueryVariant 

p  data.h 

exercise 

ExerciselD 

basic.h 

Calls 

Function 

Where  Described 

network  respond  to  auerv  Pkt 

Section  2.1.1.3.1.63.2 

Table  2.1>115:  process_status_query  Information. 
2.1.1.3.2.34.2  process_query_rae 

This  routine  processes  Status  Query  PDUs  by  calling  libSendNet  to  send  a  transaction 
response  to  the  query. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Pkt 

pointer  to  StatusQueryVariant 

p  data.h 

oriainator 

pointer  to  SimulationAddress 

address.h 

tid 

T  ransactionidentif  ier 

address.h 

exercise 

ExerciselD 

basic.h 

Calls 

Function 

Where  Described 

NOTE  FOR  US 

network  respond  to  query  trans 

Section  2.1.1.3.1.63.1 

Table  2.1-116:  process_query_me  Information. 

2.1.1.3.2.35  tgt_fire  cmd.c 

(ysiinnet/reiease/src/vehicIe/libsrc/libRcvNet/tgt_fire_cmd.c) 

The  code  in  this  file  is  not  used  in  the  Version  6.6  release. 
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2.1.1.3.2.36  tgt_handoff.c 

(ysinmetAelease/src/vehicle/libsrc/libRcvNei/tgt_handoff.c) 

The  code  in  this  file  is  not  used  in  the  Version  6.6  release. 

2.1.1.3.2.37  tgt_vis.c 

(ysinmetAelease/srcArehicle/libsrc/libRcvNet/tgt_vis.c) 

The  code  in  this  file  is  not  used  in  the  Version  6.6  release. 

2.1.1.3.2.38  veh^appear.c 

(ysiinnet^lease/src/vehicle/libsic/IibRcvNet/veh_appear.c) 


Includes: 

"rcvJoc.h" 

”net_stats.h" 

"pro_sim.h" 

"sim_macros.h 

"niass_stdc.h" 

"dgi_stdg.h" 

"sini_cig_if.h" 


"UbhuU.h" 

•'Ubkin.h" 

"Ubrva.h" 


II 


2.1.1.3.2.38.1  process_update 


This  routine  processes  the  Vehicle  Appearance  PDUs  by  calling  the  librva  routine, 
rva_process_u  pda  te() . 


1  Paramaters  1 

Parameter 

Where  Typedef  Declared 

P 

register  pointer  to 
VehicieAppearanceVariant 

p_sim.h 

1  Calls  1 

Function 

Where  Described 

NOTE  FOR  US 

rvajarocess  update 

Section  2.5.12.20.5 

Table  2.1-117:  process_update  Information. 
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2.1.2  CIG  Interface  Software 


The  CIG  (Computer  Image  Generation)  System  is  accessed  through  a  set  of  C  software 
libraries  organi^  in  a  manner  similar  to  ^at  of  the  network  interface  modules.  These 
libraries  provide  the  high  level  interface  needed  to  easily  communicate  with  the  CIG.  The 
files  included  in  this  CSC  are  shown  in  Figure  2.1-3.  The  third  level  CSCs  associated  with 
the  QG  Interface  software  are  CIG  Device  Interface  and  CIG/SIM  Buffer  Interface. 


5.1.2.1.1 


5.1.2.2.1 


llbmsg 
5.1. 2.2.2 


libproc 
5.1. 2.2.3 


libvflags 

5.1.2.2.4 


libio_simul 
5.1. 2.2.5 


m1_clg.c 

5.1.2.2.6 


m2_cig.c 
5.1. 2.2.7 


kato_clg.c 

5.1. 2.2.8 

kato_view.c 

5.1.2.2.9 


Figure  2.1-3:  CIG  Interface  software  structure. 
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2.1.2.1  CIG  Device  Interface 

The  CIG  Device  Interface  provides  high  level  device  independent  routines  to  communicate 
with  the  CIG.  The  Ml,  M2,  and  Ste^th  simulators  use  different  Sim  host  computers,  as 
well  as  different  interface  devices  to  communicate  between  die  CIG  and  Sim  host 
ccMi^uters.  The  Ml  communicates  via  a  DRl  IW  interface  while  the  M2  communicates  via 
a  VME  interface.  The  Stealth  3  communicates  with  a  DRl  IW  interface.  The  CIG  Device 
Interface  deals  with  this  difference  exclusively,  thus  allo'ving  the  actud  interface  device  to 
be  transparent  to  the  user.  It  contains  one  CSU,  libcif. 


2. 1.2. 1.1  libcif 

(Vsimnet^lease/src/libsrc/libcif  [libcif]) 

Libcif  contains  routines  which  allow  the  user  to  initialize  the  devices,  and  to  obtain  a  piece 
of  shared  memory  to  use  as  the  buffer  to  transfer  data  between  the  CIG  and  simulation 
host,  and  routines  to  start  the  transfer  as  well  as  those  which  indicate  that  the  transfer  has 
been  completed. 


2. 1.2. 1.1.1  connect.c 

(ysimnet/release/src/libsrcAibcif/connect.c) 

This  file  contains  a  routine  which  connects  the  process  to  an  interface. 

Includes: 

libcif.h 

Defines: 

DEBUG 


2. 1.2. 1.1. 1.1  cif_connect 

This  routine  attempts  to  connect  to  the  interface  specified  by  the  his  interface  argument 
This  routine  will  wait  until  it  connects  to  its  peer  if  the  wait  flag  is  TRUE;  otherwise,  it  will 
return  immediately  with  an  indication  of  success  or  failure.  A  pointer  to  the  send  buffer  is 
returned  in  sendjnf,  the  size  of  the  send  buffer  is  returned  in  send_buf_size\  and  the  size 
of  the  receive  buffer  is  returned  in  receive  bitf  size. 

Under  Chrysalis:  A  connection  to  a  DRl  1  is  attempted  if  the  enviroment  string  "DRl  l_n 
address"  is  found  in  the  environment,  where  n  is  the  hisjnterface  argument  and  address  is 
the  physical  address  that  the  DRl  1  is  to  use.  The  library  looks  for  an  environment  variable 
ClF_BUFFERS_n_TO  m  to  determine  the  size  of  tiie  buffers  to  use.  n  is  the  id  of 
myjnterface  an5  m  is  tEe  id  of  his  jnterface.  The  format  of  the  environment  string  is 
"CIF_BUFFERS_n_TO_m  read_buf_size  write_buf_size".  For  the  Butterfly, 
hisjnterface  must  be  the  unique  integer  associated  with  the  peer  process. 

Under  UNIX:  For  the  DRl  1,  hisjnterface  corresponds  to  the  minor  device  number  of  the 
DRl  1  device,  i.e.,  0  for  /dev/drO,  1  for  /dev/dr  1,  etc. 
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_ _ Parameters _ _ 

Parameter  [Type  [Where  Typedef  Declared 

his  interface _ unsigned _ Standard _ 

send  but _ pointer  to  a  pointer  to  char  Standard _ 

send  but  size _ hit _ Standard _ 

receive  but  size _ jnt _ Standard _ 

wait  int  Standard 

Table  2.1-118:  cif_connect  Information. 

If  a  Butterfly  machine  is  used: 


1  Internal  Variables  | 

Internal  Variable 

Type 

Where  Typedef  Declared 

ptable 

pointer  to 

cif  connection  table 

Section  2.1. 2.1. 1.5  libcif.h 

namelSOi 

char 

Standard 

penv 

pointer  to  char 

Standard 

pdr11 

pointer  to  device 

drdev.h 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

failed 

0 

int 

successful 

I  Errors  I 

Error  Name 

Reason  for  Error 

ENETDOWN 

cif  interface  not  initialized 

ENXIO 

bad  interface  number 

EISCONN 

is  already  connected 

EWOULDBLOCK 

operation  not  started 

ENOBUFS 

incompatible  buffer  size 

I  Calls  I 

Function 

Where  Described 

map  mbregion 

Standard  library  function  for  the  Butterfly 

Make  Obi 

Standard  library  function  for  the  Butterfly 

map  to  multibus 

Standard  library  function  for  the  Butterfly 

Standard  library  function  for  the  Butterfly 

Name  Bind 

Standard  library  function  for  the  Butterfly 

Find  Value 

Standard  library  function  for  the  Butterfly 

Table  2.1-119:  cif_connect  Information  for  the  Butterfly  machine. 
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If  a  Masscomp  machine  is  used: 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Tvpedef  Declared 

ptable 

pointer  to 

cif  connection  table 

Section  2.1 .2.1. 1.5  iibcif.h 

Ddr11 

pointer  to  device 

drdev.h 

I  Return  Values  I 

Return  Value 

Meaning 

•1 

int 

failed 

0. 

int 

successful 

1  Errors  1 

Error  Name 

Reason  for  Error 

ENETDOWN 

cif  interface  not  initialized 

ENXIO 

bad  interface  number 

EISCONN 

is  aiready  connected 

Table  2.1-120:  cif_connect  Information  for  the  Masscomp  machine. 


2. 1.2. 1.1. 2  data.c 

(./simnet/release/src/libsrc/libcif/data.c) 

This  file  contains  variable  declarations  and  constant  definitions  to  be  used  within  libcif. 


2. 1.2. 1.1. 3  disconnect.c 

(./simnet/release/src/libsrc/libcif/disconnect.c) 

This  file  contains  the  routine  which  closes  the  connection  with  an  interface. 

Includes: 

"libcif.h" 


Defines: 

SEBUG 


2. 1.2. 1.1. 3.1  cif_disconnect 

This  routine  attempts  to  disconnect  from  the  interface  specified  by  the  his  jnterface 
argument  This  routine  will  wait  until  it  is  able  to  disconnect  with  its  peer  if  the  wait 
argument  is  TRUE,  and  will  return  with  an  indication  of  success  if  the  connection  has  been 
broken.  An  indication  of  failure  is  returned  if  the  connection  cannot  be  broken. 

For  the  DRl  1,  his  interface  corresponds  to  the  minor  device  number  of  the  DRl  1  device 
(i.e.,  0  for/dev/diO,  1  for /dev/dr  1,  etc.).  For  the  Butterfly,  hisjnterface  must  be  the 
unique  integer  associated  with  the  peer  process. 
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1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

his  interface 

int 

Standard 

wait 

int 

Standard 

Table  2.1*121:  cif_disconnect  Information. 
If  a  Butterfly  machine  is  used: 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

ptable 

pointer  to 

cif  connection  table 

Section  2.1 .2.1 .1.5  libcif.h 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

failure 

0 

int 

success 

Errors 

Error  Name 

Reason  for  Error 

ENETDOWN 

communication  interface  not  initialized 

ENOTCONN 

not  connected 

ENXIO 

bad  interface  number 

Calls 

Function 

Where  Described 

unmap.mbregion 

Standard  library  function  for  the  Butterfly 

unmap_to_multibus 

Standard  library  fundion  for  the  Butterfly 

Unmap_Obi 

Standard  library  function  for  the  Butterfly 

Name_Unbind 

Standard  library  function  for  the  Butterfly 

Table  2.1*122 
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If  a  Masscomp  machine  is  used: 


1  Internal  Variables  I 

Internal  variable 

Type 

Where  Typedef  Declared 

ptable 

pointer  to 

cif  connection  table 

Section  2.1. 2.1. 1.5  libcif.h 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

success 

-1 

int 

failure 

Errors 

Error  Name 

Reason  for  Error 

ENETDOWN 

communication  interface  not  initialized 

ENOTCONN 

not  connected 

ENXIO 

bad  interface  number 

Table  2.1-123:  cif_disconnect  Information  for  the  Masscomp  machine. 


2. 1.2. 1.1.4  init.c 

(Vsimnet/release/src/libsic/libcifAniLc) 

This  file  contains  a  routine  which  initializes  the  CIG  interface  driver. 

Includes: 

"Ubcif.h" 

Defines: 

DEBUG 


2. 1.2. 1.1. 4.1  cifjnit 

This  routine  initializes  the  communications  driver.  This  routine  takes  only  one  argument, 
interface,  which  is  the  interface  number  for  the  caller.  This  routine  is  called  only  once  to 
initialize  this  module. 

For  the  DRl  1,  the  interface  argument  must  be  0.  For  the  Butterfly,  the  interface  argument 
must  be  an  integer  in  the  range  0  to  MAX_CIF_CX)NNECnONS-l,  and  it  must  be  unique 
for  each  communication  process  on  the  machine. 

This  call  returns  0  if  successful  and  -1  if  not  successful. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

interface 

int 

Standard 

Table  2.1-124:  ciMnit  Information. 
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If  a  Butterfly  machine  is  used; 


Return  Value 


-1 


Return  Values 


Meanin 


successful 


failed 


Errors 

Error  Name 

Reason  for  Error 

EALREADY 

interface  already  initialized 

ENXIO 

bad  interface  number 

Table  2.1>12S:  ciMnit  Information  for  the  Butterfly  Machine. 
If  a  Massconq)  machine  is  used: 


Internal  Variables 


Internal  Variable 


shmat 


size 


kj 


ptable 


dril  Dane  oaddr 


buffers  vaddr 


buffers  oaddr 


dril  physical  addresses 


f 


total 


irs 

irs 

irs 


inter  to  char 


inter  to  char 


inter  to  char 


int 


int 


pointer  to 

cif  connection  table 


irs 

irs 


inter  to  char 


inter  to  char 


inter  to  int 


inter  to  FILE 


Where  Typedef  Declared 


Standard 


Standard 


Standard 


Standard 


Standard 


Section  2.1. 2. 1.1. 5  libcif.h 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Return  Values 


Return  Value 


-1 


Meanin 


success 


failure 


Error  Name 


EALREADY 


ENXIO 


Errors 


Reason  for  Error 


interface  already  initialized 


invalid  interface  number 


Function 


arce  cif  definition 


Calls 


Where  Described 


Section  2.1. 2. 1.1. 6.1 


Table  2.1>126:  ciMnit  Information  for  the  Masscomp  Machicne. 


2. 1.2. 1.1. 5  libcif.h 
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(./simnet/release/src/libsrc/libcifi^bcif.h) 

This  file  contains  structure  and  constant  definitions,  as  well  as  variable  and  function 
declarations,  to  be  used  in  libcif. 


2. 1.2. 1.1. 6  parse.c 

(./simnet/release/src/libsic/libcif^arse.c) 

This  file  contains  the  code  to  parse  a  definition  file. 

includes: 

stdio.h 


2. 1.2.1. 1.6.1  parse_cif_definition 

This  routine  parses  information  in  the  fUc  filename  for  the  interface  specified  by  the 
argument  n.  recu^  indicates  where  to  return  the  read  size,  writep  indicates  where  to 
return  the  write  size. 

The  parameter  file  which  is  supplied  is  opened.  The  first  character  on  a  line  is  examined. 
Blank  lines  are  skipped.  Success  is  indicated  if  this  line  is  the  same  as  the  requested  line. 
Failure  is  indicated  if  the  file  is  unopenable,  or  if  the  line  is  not  found.  This  routine  returns 
0  if  successful  and  -1  if  not  successful. 


Table  2.1>127:  parse_cif_definition  Information. 
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2. 1.2. 1.1. 7  receive.c 

(ysimnet/release/src/libsrc/libcifAeceive.c) 

This  file  contains  the  code  which  is  used  to  receive  a  buffer. 


Includes: 

"Ubcif.h" 

"rtc.h" 


2. 1.2. 1.1. 7.1  cif_receive 

This  routine  receives  a  buffer  finom  the  peer  specified  by  the  his  interface  assignment  A 
pointer  to  the  buffer  is  returned  in  pbuf .  size  is  the  size  of  the  buffer.  If  wait  is  true,  this 
call  will  wait  until  the  transfer  is  completed;  otherwise,  this  call  will  return  immediately 
with  an  indication  of  success  or  failure. 

For  the  DRl  1 ,  his  interface  corresponds  to  the  minor  device  number  of  the  DRl  1  device 
(i.e.,  0  for /dev/drO,  1  for /dev/dr  1,  etc.).  For  the  Butterfly,  his  interface  must  be  the 
unique  integer  associated  with  the  peer  process. 

This  routine  returns  0  if  successful  and  -1  if  not  successful. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

his  interface 

int 

Standard 

pbuf 

char 

Standard 

size 

int 

Standard 

wait 

int 

Standard 

Table  2.1<128:  cif_receive  Information. 
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If  a  Butterfly  machine  is  used: 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

ret 

int 

Standard 

whichbuf 

int 

Standard 

ptable 

pointer  to 

cit  connection  table 

Section  2.1. 2.1. 1.5  libcif.h 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

failed 

0 

int 

successful 

Errors 

Error  Name 

Reason  for  Error 

ENETDOWN 

cif  interface  not  initialized 

ENXIO 

bad  interface  number 

ENOTCONN 

not  connected 

EWOULDBLOCK 

operation  not  started 

Calls 

Function 

Where  Described 

dr1l  receive 

Section  2.1. 2.1. 1.7.2 

cif  disconnect 

Section  2.1. 2.1. 1.3.1 

Table  2.1-129:  cif_receive  Information  for  Butterfly  machine. 
If  a  Masscomp  machine  is  used: 


Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

ptable 

pointer  to  struct 
cif  connection  table 

Section  2.1. 2.1. 1.5  libcif.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

failed 

0 

int 

successful 

1  Errors  1 

Error  Name 

Reason  for  Error 

ENETDOWN 

cif  interface  not  initialized 

ENXIO 

bad  interface  number 

ENOTCONN 

not  connected 

1  Calls  1 

Function 

Where  Described 

dril  receive 

Section  2.1. 2.1. 1.7.2 

Table  2.1>130:  cif_receive  Information  for  the  Masscomp  machine. 
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2. 1.2.1. 1.7.2  drll_receive 

This  routine  is  called  to  receive  a  buffer  via  a  DRl  1  interface  card,  ptable  is  a  pointer  into 
the  cif  connection  table.  pbitf  is  a  pointer  to  the  buffer  to  be  received,  size  is  the  size  of 
the  buSer.  wait  is  a  flag  which  indicates  if  the  buffer  has  been  received. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

ptable 

pointer  to 

cif  connection  table 

Section  2.1. 2.1. 1.5  libcif.h 

Dbuf 

pointer  to  pointer  to  char 

Standard 

size 

int 

Standard 

wait 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

ret 

int 

Standard 

i 

int 

Standard 

tmo 

unsioned  short 

Standard 

Ddr11 

pointer  to  reoister  device 

drdev.h 

I  Return  Values  i 

Return  Value 

Type 

Meaning 

-1 

int 

failed 

0 

int 

successful 

1  Errors  1 

Error  Name 

Reason  for  Error 

EINPROGRESS 

operation  started  but  not  complete 

1  Calls  1 

Function 

Where  Described 

BSWAP 

Section  2.1. 2.1. 1.5  libcif.h  (macro  definition) 

HIWORD 

Section  2.1. 2.1. 1.5  libcif.h  (macro  definition) 

LOWORD 

Section  2.1. 2.1. 1.5  libcif.h  (macro  definition) 

Table  2.1>131:  drll  receive  Information. 
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2. 1.2. 1.1. 8  send.c 

(ysimnet/telease/src/libsrc/libcif/sendc) 

This  file  contains  the  code  which  is  used  to  send  a  buffer  to  the  CIG. 

Includes: 

"libcif.h" 


2. 1.2.1. 1.8.1  cif_send 

This  routine  sends  the  buffer  birf  of  length  size  bytes  to  the  peer  specified  by  the 
hisjnterface  assignment.  A  pointer  to  the  buffer  is  returned  in  pbitf.  If  wait  is  true,  this 
call  will  wait  until  the  transfer  is  completed;  otherwise,  this  call  will  return  immediately 
with  an  indication  of  success  or  failure. 

For  the  DRl  1,  his  jnterface  corresponds  to  the  minOT  device  number  of  the  DRl  1  device 
(i.e.,  0  for  /dev/diO,  1  for  /dev/dr  1,  etc.).  For  the  Butterfly,  his  jnterface  must  be  the 
unique  integer  associated  with  the  peer  process. 

This  routine  returns  0  if  successful  and  -1  if  not  successful. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

his  interface 

int 

Standard 

buf 

pointer  to  char 

Standard 

size 

int 

Standard 

wait 

int 

Standard 

Table  2.1>132:  cif^send  Information. 
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If  a  Butterfly  machine  is  used: 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

ret 

int 

Standard 

whichbuf 

int 

Standard 

ptable 

pointer  to 

cif  connection  table 

Section  2.1. 2.1. 1.5  libcif.h 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

failed 

0 

int 

successful 

Errors 

Error  Name 

Reason  for  Error 

ENETDOWN 

cif  interface  not  initialized 

ENXIO 

bad  interface  number 

ENOTCONN 

not  connected 

EWOULDBLOCK 

operation  not  started 

Calls 

Function 

Where  Described 

dril  send 

Section  2.1. 2.1. 1.8.2 

cif  disconnect 

Section  2.1. 2.1. 1.3.1 

Table  2.1-133:  cif_send  Information  for  the  Butterfly  machine. 


If  a  Masscomp  machine  is  used: 


Internal  Variable 


ptable 


Return  Value 


-1 


Error  Name 


ENETDOWN 


ENXIO 


ENOTCONN 


Function 


dr11  send 


Internal  Variables 


e 


pointer  to 

cit  connection  table 


iE7n 


Where  Typedef  Declared 


Section  2.1. 2.1 .1.5  libcif.h 


Return  Values 


Meaning 


failed 


successful 


Errors 


Reason  for  Error 


cif  interface  not  initialized 


bad  interface  number 


not  connected 


Calls 


Where  Described 


Section  2.1 .2.1. 1.8.2 


Table  2.1-134:  cif_send  Information  for  the  Masscomp  machine. 
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2. 1.2. 1.1.8. 2  drll^send 

This  routine  is  called  to  send  a  buffer  via  a  DRl  1  interface  card,  ptable  is  a  pointer  into  the 
cif  connectionjable.  pbitfis  a  pointer  to  the  buffer  to  be  receiv^.  size  is  ±e  size  of  the 
buffer,  wait  is  a  flag  which  indicates  if  the  buffer  has  been  received. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

ptable 

pointer  to 

cif  connection  table 

Section  2.1. 2.1. 1.5  Iibcif.h 

but 

pointer  to  char 

Standard 

size 

int 

Standard 

wait 

int 

Standard 

internal  Variables 

Internal  Variable 

Where  Tvoedef  Declared 

ret 

int 

Standard 

i 

int 

Standard 

but  oaddr 

pointer  to  char 

Standard 

Ddr11 

pointer  to  reoister  device 

drdev.h 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

-1 

int 

failed 

0 

int 

successful 

1  Errors  1 

Error  Name 

Reason  for  Error 

EWOULDBLOCK 

operation  not  started 

EINPROGRESS 

operation  started  but  not  complete 

I  Calls  1 

Function 

Where  Described 

BSWAP 

Section  2.1. 2.1. 1.5  iibcif.h  (macro  definition) 

HIWORD 

Section  2.1. 2.1. 1.5  Iibcif.h  (macro  definition) 

LOWORD 

Section  2. 1.2.1. 1.5  Iibcif.h  (macro  definition) 

Table  2.1-135:  drll  send  Information. 
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2. 1.2. 1.1. 9  uninit.c 

(ysimnei/release/sic/libsrc/libci£^uninitc) 

This  file  contains  a  routine  which  uninitializes  the  communications  driver. 


2. 1.2.1. 1.9.1  cif_uninit 

This  routine  uninitializes  the  communications  driver  and  deallocates  all  resources  allocated 
by  the  communications  driver.  This  routine  returns  0  if  successful  and  -1  if  not  successful. 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

ret  (Masscomo  only) 

int 

Standard 

ptable  ( Masscomp  only) 

pointer  to 

cif  connection  table 

Section  2.1. 2.1. 1.5  libcif.h 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

success 

-1 

int 

failure 

Errors 

Error  Name 

Reason  for  Error 

ENETDOWN 

communications  inteiface  is  down 

Calls 

Function 

Where  Described 

cif  disconnect 

Section  2.1. 2.1. 1.3.1 

Table  2.1-136:  cif^iiininit  Information. 
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2.1.2.2  CIG-SIM  Buffer  Interface 

The  CIG-SIM  interface  consists  of  collection  of  messages  which  are  used  to  transfer 
infonnation  between  the  CIG  and  the  Simulation  Host  These  messages  are  placed  into  a 
buffer  and  transferred  via  the  interface  device.  Messages  sent  from  the  CIG  to  the 
Simulation  Host  include  informational  messages  such  as  those  about  local  terrain,  laser 
range,  and  hits,  as  well  as  setup  messages  that  indicate  which  terrain  database  and  DED  are 
being  used.  Messages  sent  from  the  Simulation  Host  to  the  CIG  contain  information  about 
the  vehicle's  current  position  and  orientation,  position,  orientation  and  type  for  other  visible 
vehicles  in  the  worl^  and  information  necessary  to  paint  ballistic  effects  such  as  tracers, 
muzzles,  flashes,  and  armor  and  ground  bursts.  During  setup,  the  Simulation  Host  also 
sends  bikers  contaiiung  the  configuration  of  the  viewports  and  ballistics  trajectory 
information.  (Reference  Table  1.1-2  and  BBN  Document  #8912  -  BBN  GT100™CIG  to 
Simulation  Host  Interface  Manual.) 

The  CIG/SIM  Buffer  Interface  consists  of  the  following  CSUs: 

libcig 

libmsg 

libproc 

libvflags 

libio_simul 

ml_cig.c 

m2_cig.c 

kato_cig.c 

kato_view.c 


2. 1.2.2. 1  libcig 

(ysimnetA'elease/src/vehicle/libsrc/libcig  [libcig]) 

Libcig  contains  the  routines  to  irutialize,  setup,  and  synchronize  the  CIG  as  well  as  actually 
send  and  receive  the  transfer  buffers.  TTie  routines  to  send  and  receive  buffers, 
cig  send  buffer()  and  cig_receive_buffer()  respectively,  are  called  every  frame  by 
io_siniiil(J.  Libcig  contain^  the  interfaces  between  libmsg  and  libcif  and  between  libcif 
and  libproc.  Libcig  sends  formatted  message  buffers  from  libmsg  to  libcif.  Libcig  also 
receives  raw  buffers  from  libcif  and  sends  them  for  processing  to  libproc. 


2. 1.2. 2. 1.1  check  sizes.c 

(ysitnnet^lease/src/vehicle/libsrc/libcig/check_sizes.c) 


Includes: 

"stdio.h" 

"sim_dfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"cig_local.h" 

"libmsg.h" 

"gbuffer.h" 
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2. 1.2. 2. 1.1.1  check_buffer_sizes 

This  routine  checks  that  the  buffer  sizes  being  used  are  compatible  with  the  transfer 
fimcdonality.  Tlie  parameter  num  indicates  Ae  buffer  number  to  use.  'Diis  routine  checks 
that  the  buffer  to  be  used  is  compatible  with  the  program  being  run.  Note  that  although  the 
code  is  written  to  support  more  than  one  CIG,  the  PMTRADE  system  will  contain  only  one 
CIG,  CIGl. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

num 

int 

Standard 

Table  2.1-137:  cbeck_buffer_sizes  Information. 


2. 1.2.2. 1.2  cig_local.c 

(Vsimnet/release/srcA'ehicle/libsic/libcig/cig.local.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

This  file  contains  default  settings  for  the  CIG  system,  and  global  variables  used  by  the 
library. 


2. 1.2. 2. 1.3  cig_local.h 

(7simnet^lease/src/vehicle/libsrc/libcig/cig_local.h) 

Includes  "sim_types.h" 

Global  Variable  Declarations: 
using_graphics 
debug 
db_ptr 
db_oveiTide 
database_name[30] 
printbuffers 
send_bufl] 
receive_bufD 
cigl_present 
cig2_present 
my_num 
req_send_size 
req_receive_si2e 
initial_send_si2e 
initial_receive_size 
initial_transfer_size 
use_requested_sizes 

External  Procedure  Declaration: 
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check_buffer_sizes() 

Defines: 

DR_THRU_KERNAL 

DR_MASSOOMP 

DRJDELTA 

BUF_SIZE 


2. 1.2. 2. 1.4  cig_no_op.c 

(ysiinnet/release/src/vehicle/libsrc/libcig/cig_no_op.c) 


Includes: 

"sim_types.h" 

"stdio.h" 

”mass_stdc.h" 

"dgi_stdg.h'' 

"sim_cig_if.h" 

"Ubmsg.h" 


2. 1.2.2. 1.4.1  cig__prepare_no_op 

This  routine  flushes  all  of  the  |»inters  in  the  buffer,  and  push_insg_cig_ctl  (C_STOP) 
puts  a  message  in  die  buffo:  which  instructs  the  CIG  to  go  into  w  idl^state.  The  routine 
flush^bufferQ  clears  the  buffer  of  everything  but  other  vehicle  information;  however, 
dg  prepare  no_op()  is  not  usually  called  when  other  vehicle  information  is  in  the 
biS?er.  FuncSonally,  the  entire  buffer  is  cleared  by  this  call. 


1  Calls  1 

Function 

Where  Described 

flush  buffer 

Section  2.1.2.2.2.28.1 

Dush  msQ  ciQ  ctl 

Section  2.1.2.2.2.68.1 

Table  2.1-138:  cig_prepare_no_op  Information. 


2. 1.2.2. 1.5  dg_nuse_gra.c 

(ysinmetA«lease/src/vehicl^ibsrc/libdg/cig_nuse_gra,c) 


Includes: 

•'stdio.h" 

"sim_dfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"cig_local.h" 


2. 1.2. 2. 1.5.1  cig_not_using_graphics 

This  routine  sets  the  using_graphics  flag  to  FALSE.  This  routine  is  used  for  testing 
purposes  to  notify  the  system  to  not  issue  any  graphics  commands. 
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2. 1.2. 2. 1.6  cig_prepare.c 

(ysimnei/release/src/vehicle/libsrc/libcig/cig_prepare.c) 


"stdio.h" 

"ermo.h" 

"siin_dfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"cig_local.h" 


2. 1.2. 2. 1.6.1  cig_prepare 

This  routine  prepares  the  CIG  by  setting  up  the  interface  between  libcig  and  libcif.  The 
parameter  okjo _print  places  the  system  into  verbose  nxxle,  where  status  messages  will  be 
printed  during  operation. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

lok  to  print 

int 

Standard 

Errors 

1  Error 

Reason  for  Error 

IcH  inn  failed 

cif  initialization  failed 

Calls 

Function 

Where  Described 

cif  init 

Section  2.1.2.1. 1.4.1 

cif  connect 

Section  2.I.2.1. 1.1.1 

check  buffer  sizes 

Section  2.1.2.2.1.1.1 

setup  buffer  ptrs 

Section  2.1.2.2.1.32.1 

cio  not  usino  oraohics  (Butterfly  Machine) 

Section  2.1. 2.2.1. 5.1 

Table  2.1>139:  cig_prepare  Information. 
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2. 1.2. 2. 1.7  cig_proc_buf.c 

(ysiinnet^le^/src/vehicle/libsic/libcig/cig_proc_buf.c) 

Includes' 

"sim_types.h" 

"stdio.h" 

"inass_stdc.h" 

"dgi_stdg.h" 

'•Ubcig.h" 

''cig_local.h" 


2. 1.2.2. 1.7.1  cig_process_buffer 

This  routine  detennines  if  a  buffer  is  to  be  processed.  If  the  buffer  is  not  to  be  processed, 
i.e.,  cig  not_ok_to_process  bufferO  is  set,  this  routine  will  not  allow  libproc  to 
receive  the  imssage.  If  the  buiFfer  is  to  be  processed,  a  call  is  made  to  process_buffer() 
inlibfvoc. 


1  Calls  1 

Function 

Where  Described 

cia  not  ok  to  orocess  buffer 

Section  2.1.2.2.1.24.1 

orocess  buffer 

Section  2.1.2.2.3.8.1 

Table  2.1-140:  cig_process_buffer  Information. 


2. 1.2. 2. 1.8  cig_r  start.c 

(ysiinne?release/src/vehicle/libsrc/libcig/cig_r_start.c) 


Inlcudes: 

''sim_types.h" 

"stdio.h" 

"mass_stdc.h" 

"dgi_stdg,h" 

"sim_cig_if.h" 

"libmsg.h" 

"Ubcig.h" 

"cig_local.h" 


Global  Variable  Declarations; 
print_checkb 
ded_name[30] 
ded_namel[3()] 


This  file  is  used  to  download  reconfigurable  viewport  information  and  trajectory  tables,  and 
it  specifies  the  database  and  DED  to  be  used. 
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2. 1.2.2. 1.8.1  use_print_checkb 

This  routine  sets  the  value  of  print  checkb  equal  to  1,  allowing  check_all()  to  be  used  to 
check  the  buffer  status  after  communications.  It  should  be  used  only  for  debugging 
purposes. 


2. 1.2. 2. 1.8. 2  set  ded  name 


This  routine  changes  the  name  of  the  DED  from  the  default  to  name.  The  default  name  is 
ded_otw.a301. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

name 

pointer  to  char 

Standard 

Table  2.1-141:  set  ded  name  Information. 


2. 1.2.2. 1.8.3  cig_reconfig_start 


This  routine  notifies  the  CIG  of  the  interface  configurations  and  places  the  CIG  in 
simulation  mode.  The  interface  configurations  include:  the  database  names,  DED  names, 
initial  location,  trajectory  tables,  viewport  nodes,  and  configuration  nodes. 


1  Calls  1 

Function 

Where  Described 

cig  receive  buffer 

Section  2.1. 2.2. 1.9.1 

flush  buffer 

Section  2.1.2.2.2.28.1 

push  msQ  cia  ctl 

Section  2.1.2.2.2.68.1 

set  buffer  num 

Section  2.1.2.2.2.113.1 

cia  send  buffer 

Section  2.1.2.2.1.10.1 

check  all 

Section  2.1.2.2.2.17.1 

aet  front  of  send  buffer 

Section  2.1.2.2.2.32.1 

multi  cia  oreoend  dr1l  pKt  size 

Section  2.1.2.2.2.71.1 

set  chunk  size 

Section  2.1.2.2.3.23.1 

push  msa  file  descr 

Section  2.1.2.2.2.72.1 

weapons  download  ballistics  table 

Sections  2.2.3.2.  and  2.3.3. 2 

cia  msa  configure  traj 

Section  2.1.2.2.2.23.3 

cig  setup  configuration 

Section  2.1.2.2.1.11.1 

cig  prepare  buffer 

Sections  2.1.2.2.6.6,  2.1.2.2.7.5,  and 
2.1.2.2.8.4 

Table  2.1-142:  cig_reconfig_start  Information. 


2. 1.2.2. 1.9  cig_recv_buf.c 

(ysiiTinet/iel^e/src/vehicle/libsrc/libcig/cig_recv_buf.c) 

Includes: 

"stdio.h" 

"sim_dfns.h" 
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’’rtc.h" 

"cig_local.h" 

"Ubcig.h" 


Constant  Defines: 
C_RECV 
C_POLL 
C_ONE 
C_TWO 


2. 1.2.2. 1.9.1  cig_receive_buffer 

This  routine  is  used  to  receive  a  buffer  (interfacing  with  libcif),  and  is  called  every  ffanx. 
The  host  is  placed  into  either  receive  state  or  polling  state.  At  Ae  start  of  die  frame,  it  is  in 
receive  state.  First  this  routine  checks  for  the  number  of  CIGs,  then  it  calls  cif_receive() 
and  waits  for  a  return.  If  the  return  from  cif  receive()  is  zero,  the  buffer  was  properly 
received,  cig  state  is  then  cleared  to  zero,  an3  the  routine  is  finished  until  the  next  frame. 
If  the  return  fiom  cif_receiveO  is  non-zero,  the  host  enters  the  polling  state.  During 
polling  state,  it  continues  working,  but  periodically  checks  for  a  return  value  from 
cif_receiveO.  cig  state  may  only  be  cleared  to  zero  when  the  buffer  has  been  received. 
If  more  than  one  CIG  exists,  the  cif_receive()  returns  from  both  CIGs  must  be  zero  in 
order  to  clear  cig  state  to  zero. 


1  Internal  Variables  I 

Variable 

Where  Tvpedef  Declared 

da  state 

int 

Standard 

ciQ  mode 

int 

Standard 

start  frame  time 

int 

Standard 

ret1 

int 

Standard 

ret2 

int 

Standard 

temp 

int 

Standard 

I  Return  Values  I 

Return  Value 

Type 

Meanina 

cig_state 

int 

the  current  state  of  the  CIG; 

-  if  zero,  receive  buffers  are 
complete  for  all  CIGs 

-  if  non-zero,  receive  buffers 
are  not  complete  for  one  or 
more  CIGs 

1  Calls  1 

Function 

Where  Described 

bbd  bit  out 

Section  2.f.5.1.4.1 

cif  receive 

Section  2.1 .2.1. 1.7.1 

aet  receive  buffer 

Section  2.1.2.2.1.21.1 

aet  receive  size 

Section  2.1.2.2.1.20.1 

rtc  stop  time 

Section  2.6.16.1.3 

rtc  start  time 

Section  2.6.16.1.2 

Table  2.1>143:  cig_receive_buffer  Information. 
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2.1.2.2.1.10  cig_send_buf.c 

(7simnetAelease/src/vehicle/libsrc/libcig/cig_send_buf.c) 


Includes: 

"simstdio.h" 

"eimo.h" 

"sim_dfns.h" 

"cig_local.h" 

"Ubmsg.h" 

"Ubcig.h" 

Qmstant  Defines: 
C_SEND 
C_POLL 
C_ONE 
C_TWO 


Static  Procedure  Declarations: 

cig_klckoff_dr_transfer() 

cig_poll_dr_trahsfer() 

cig_setup_d7-_transfer() 

Global  Variable  Declarations: 
cig_state 
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2.1.2.2.1.10.1  cig_send_buffer 

This  routine  is  used  to  send  a  buffer  (interfacing  with  libcif),  and  is  called  every  frame. 

The  host  is  set  up  in  either  send  state  or  polling  state.  At  the  start  of  Ae  frame,  it  is  in  send 
state.  The  transfer  is  initiated  (or"kicked  off)  by  calling  cig_kickoff_dr_transfer(). 
The  routine  checks  to  ensure  that  the  transfer  was  actually  starasd,  since  occasionally  the 
DRl  1  is  not  ready  to  send  when  the  kickoff  is  called.  If  the  transfer  was  initiated  and  the 
cig_kickofr_dr_transfer()  call  to  cif_send()  returns  zero,  the  buffer  was  properly 
sent  cig_state  is  cleared  to  zero,  and  the  routine  is  finished  until  the  next  frame.  If  the 
transfer  was  not  initiated,  the  host  loops  and  continues  calling 
cig_kickofr  dr_transferO  and  checking  until  the  transfer  is  initiated.  If  kickoff 
occuned  anJthe  cif_sendp  return  is  non-zero,  the  host  enters  the  polling  state.  During 
polling  state,  the  host  continues  working,  but  periodically  checks  for  a  return  value. 
cig_state  may  only  be  cleared  when  confirmation  is  received  that  the  buffer  has  been  sent 


1  Internal  Variables  1 

Variable 

Tvoe 

Where  Typedef  Declared 

retl 

int 

Standard 

ret2 

int 

Standard 

cig  mode 

int 

Standard 

Return  Values 

I  Return  Value 

Tvoe 

Meaning 

I  cig  state 

int 

the  current  state  of  the  CIG 

Calls 

Function 

Where  Described 

cig  poll  dr  transfer 

Section  2.1.2.2.1.10.3 

cig  setuD  dr  transfer 

Section  2.1.2.2.1.10.4 

cig  kickoff  dr  xfer 

Section  2.1.2.2.1.10.2 

set  send  status 

Section  2.1.2.2.1.25.2 

bbd  bit  out 

Section  2. 1.5. 1.4.1 

get  send  size 

Section  2.1.2.2.1.22.1 

cif  send 

Section  2.1. 2.1. 1.8.1 

get  front  of  send  buffer 

Section  2.1.2.2.2.32.1 

Table  2.1>144:  cig_send_buffer  Information. 
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2.1.2.2.1.10.2  cig_kickoff_dr_xfer 


This  routine  checks  for  the  number  of  CIGs  and  sends  the  buffer  by  calling  cif_send0  • 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

cia  transfers 

int 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

errno 

extern  int 

Standard 

Calls 

Function 

Vifhere  Described 

bbd  bit  out 

Section  2.1 .5.1 .4.1 

aet  send  size 

Section  2.1.2.2.1.22.1 

cK  send 

Section  2.I.2.1. 1.8.1 

aet  front  of  send  buffer 

Section  2.1.2.2.2.32.1 

Table  2.1-145:  cig_kickoff_dr_xfer  Information. 
2.1.2.2.1.10.3  cig_poll_dr_transfer 

This  routine  checks  the  return  from  cif_send0  and  clears  the  cig_state  when  the  return  is 
equal  to  zero.  ~ 


1  Internal  Variables  i 

Variable 

Type 

Where  Typedef  Declared 

retl 

int 

Standard 

ret2 

int 

Standard 

Calls 

Function 

Where  Described 

cif  send 

Section  2.1. 2. 1.1. 8.1 

aet  front  of  send  buffer 

Section  2.1.2.2.2.32.1 

aet  send  size 

Section  2.1.2.2.1.22.1 

Table  2.1-146:  cig_poll_dr_transfer  Information. 
2.1.2.2.1.10.4  cig_setup_dr_transfer 


This  routine  places  the  overall  header  on  the  CIG  message  buffer  being  sent. 


1  Calls  1 

Function 

Where  Described 

cia  msa  append  end 

Section  2.1.2.2.2.4.1 

cia  msa  prepend  overall  header 

Section  2.1.2.2.2.86.1 

set  buffer  num 

Section  2.1.2.2.2.113.1 

Table  2-147:  cig_setup_dr_transfer  Information. 


I 
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2.1.2.2.1.11  cig_set  conf.c 

(ysimnetAi3ease/src/vehicleAibsrq/libcig/cig_set_conf.c) 


Includes: 

"stdio.h" 

"sim_(ifns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

''Ubmsg.h" 

"cig_l(x:al.h" 


2.1.2.2.1.11.1  cig_setup_con  figuration 

This  routine  instructs  cig_nisg_configure_view()  in  "librnsg"  to  put  the  CIG  into 
C3G_CINFIG  state,  and  Sen  it  reads  in  and"processes  the  configuration  file.  It  formats  the 
CIG  buffer  accordingly. 


1  Calls  1 

Function 

Where  Described 

cia  msQ  confiaure  view 

Section  2.1.2.2.2.23.4 

Table  2.1-148:  cig_setup_configuration  Information. 
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2.1.2.2.1.12  cig_stop.c 

(ysimnet/i:elease/src/vehicle^bsiic/libcig/cig_stop.c) 

Includes: 

"sim_types.h" 

"stdio.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 

"Ubcig.h" 

"cig_local.h" 


2.1.2.2.1.12.1  cig_stop 

This  routine  is  used  to  place  the  CIG  into  the  stop  state,  which  means  that  it  is  idle.  In 
order  to  stop  the  CIG,  a  check  is  first  made  for  any  buffer  sends  that  are  still  pending. 
Once  the  sends  are  completed,  the  buffer  is  cleared  A  message  is  then  sent  to  the  CIG 
informing  it  of  the  settings  of  the  view  flags,  in  order  to  ensure  that  the  screens  are  turned 
off.  All  buffer  pointers  are  reset,  and  a  message  is  sent  to  the  CIG  to  switch  to  the  stop 
state.  The  DRl  1  transfer  size  is  then  reset  to  its  initial  size  (5 12k  in  each  direction). 


Table  2.1-149:  cig_stop  Information. 


Where  Described 

Section  2.1.2.2.1.25.1 
Section  2.1.2.2.1.10.1 
Section  2.1.2.2.1.9.1 
Section  2.1.2.2.2.28.1 
Section  2.1.2.2.2.106.1 
Section  2.1.2.2.4.4.1 
Section  2.1.2.2.4.3.1 
Section  2.1 .2.2.2.113.1 
Section  2.1.2.2.2.15.1 
Section  2.1.2.2.2.68.1 
Section  2.1.2.2.2.79.1 


Function 


et  send  status 


ciq  send  buffer 


ciq  receive  buffer 


flush  buffer 


cia  msa  oreoend  view  fiaas 


et  view  fiaas 


et  br  vals 


set  buffer  num 


buffer  reset 


ush  msa  cia  cti 


multi  cig  oreoend  dril  okt  size 


P 


P 
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2.1.2.2.1.13  cig_sync.c 

(ysimnet/release/src/vehicle/libsrc/libcig/cig_sync.c) 


Includes: 

"sim_types.h" 

"stdio.h" 

"eirno.h" 

"mass.stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubinsg.h" 

"Ubcig.h" 

"cig_local.h" 


Variable  Declarations: 
si2e_of_header 
inax_cig_transfer_size 
print_checkb 


2.1.2.2.1.13.1  cig_synchronize 

This  routine  synchronizes  the  CIG  and  the  Simulation  Host  by  first  ensuring  that  all 
pending  sends  are  completed,  and  then  by  performing  ten  read/write  sequences.  The 
parameter  okjo _print  places  the  system  into  verbose  mode,  where  status  messages  will  be 
printed  during  operation. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

ok  to  print 

int 

Standard 

i  Internal  Variables  1 

1  Variable 

Where  Typedef  Declared 

L _ _ _ 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

aet  send  status 

Section  2.1.2.2.1.25.1 

cia  send  buffer 

Section  2.1.2.2.1.10.1 

cio  receive  buffer 

Section  2.1. 2.2.1. 9.1 

flush  buffer 

Section  2.1.2.2.2.28.1 

push  msa  cia  ctl 

Section  2.1.2.2.2.68.1 

set  buffer  num 

Section  2.1.2.2.2.113.1 

Table  2.1-150:  cig_synchronize  Information. 
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2.1.2.2.1.14  cig_uninit.c 

(ysiinnetAelease/src/vehicle/libsrc/Iibcig/cig_uninitc) 


Includes: 

"stdio.h" 

"ermo.h" 

"sim_<ifns.h" 

"mass_stdc.h" 

dgi_stdg.h" 

"smL.cig_if.h" 

"cig_local.h" 


2.1.2.2.1.14.1  cig^uninit 

This  routine  initializes  the  CIG  by  calling  cif_disconnect()  and  cif_uninit().  The 
parameter  jjrinr  checks  if  the  system  is  in  verbose  mode.  ” 


1  Parameters  1 

1  Parameter 

Type 

Where  Tvpedef  Declared 

lok  to  print 

int 

Standard 

Errors 

Error 

Reason  for  Error 

errno 

-  cif_disconnect  failed  for  cig1 
•  cif.disconnect  failed  for  cig2 

-  cif  uninit  failed 

1  Calls 

Function 

Where  Described 

cif  disconnect 

Section  2.1. 2.1. 1.3.1 

cif  uninit 

Section  2.1. 2.1. 1.9.1 

Table  2.1-151:  cig_uninit  Information. 


2.1.2.2.1.15  cig_use  gra.c 

(ysinuiet^Tease/src/vehicle/libsrc/libcig/cig_use_gra.c) 


Includes: 

"stdio.h" 

"sim_<ifns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"cig_local.h" 


2.1.2.2.1.15.1  cig_using_graphics 

This  routine  sets  the  value  of  using _graphics  equal  to  TRUE. 
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2.1.2.2.1.16  db_overri(ie.c 

(ysiimiet/release/src/vehicle/libsrc/libcig/db_override.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_<tfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"cig_local.h" 


2.1.2.2.1.16.1  cig_use_database_override_named 

This  routine  sets  the  database  name  to  db  name,  which  will  override  the  database  specified 
by  the  activate  packet 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

db  name 

pointer  to  char 

Standard 

Table  2.1-152:  cig_use_database_override_named  Information. 


2.1.2.2.1.17  get_cig2.c 

(ysimnet/release/siic/vehicle/libsrc/libcig/get_cig2.c) 


Includes: 

"stdio.h" 

"sim_types.h 

"ci&_local.h" 


ti 


2.1.2.2.1.17  get_cig2_present 

This  routine  checks  if  a  second  CIG  is  present 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

cig2_present 

int 

It  TRUE,  there  is  a  second  CIG 
present; 

If  FALSE,  only  one  CIG  is 
present 

Table  2.1-153:  get_cig2_present  Information. 


142 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.1.2.2.1.18  get_i  sizes.c 

(ysimne^release/src/vehicle/libsic/lil)cig/get_i_sizes.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_macros.h 

"cig_local.h" 


41 


2.1.2.2.1.18.1  geMnitial_sizes 

This  routine  obtains  the  initial  transfer  size  for  the  send  and  receive  buffers  via  DRl  1 
transfer.  The  default  is  512  for  the  send  buffer  and  5 12  for  the  receive  buffer. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

init  send 

pointer  to  int 

Standard 

init  recv 

pointer  to  int 

Standard 

Table  2.1*154:  get_initial_sizes  Information. 

2.1.2.2.1.19  get_max.c 

(ysimnetAelease/src/vehicle/libsrc/libcig/get_max.c) 


Includes: 

"stdio.h" 

"sim_types.h 

"cig_local.h" 


14 


2.1.2.2.1.19.1  get_max_buffer_sizes 


The  maximum  DRl  1  transfer  sizes  are  given  for  the  CIG  specified  in  bnum.  This  routine 
is  used  by^  the  CIG  utility  transfer  programs.  The  maximum  blocks  of  memory  available 
from  df_initO  for  sendmg  and  receiving  are  pointed  to  by  the  parameters  se^  and  recv. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

bnum 

int 

Standard 

send 

pointer  to  int 

Standard 

recv 

pointer  to  int 

Standard 

Errors 

Error 

Reason  for  Error 

stderr 

Invalid  buffer  number 

Table  2.1-155:  get_max_buffer_sizes  Information. 
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2.1.2.2.1.20  get_r  size.c 

(ysimnet^lease/srcA?ehicle/libsrc/libcig/get_r_size.c) 


Includes: 

"stdio.h" 

"sim_types.h 

"cig_local.h" 


tt 


2.1.2.2.1.20.1  get_receive_size 
This  routine  obtains  the  receive  buffer  size. 


1  Return  Values  1 

Return  Value 

Tvoe 

Meanina 

req_receive_size 

int 

the  receive  buffer  size  if  the 
defauit  value  was  not  used 

initial_receive_size 

int 

the  receive  buffer  size  if  the 
default  value  was  used 

Table  2.1-156:  get_receive_size  Information. 


2.1.2.2.1.21  get_recv_buf.c 

(7sininet/rel^e/src/vehicle/libsrc/libcig/get_recv_buf.c) 


Includes: 

"stdio.h" 

"siin_types.h" 

"cig_local.h" 


2.1.2.2.1.21.1  get_recei  ve_buffer 

This  routine  returns  a  pointer  to  the  beginning  of  the  receive  buffer  for  the  CIG  specified  in 
cigjiwn. 


1  Parameters  1 

1  Parameter 

Where  Tvoedef  Declared 

Ida  num 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

&receive_buf[cig_num-1 1 

pointer  to  pointer  to  char 

pointer  to  the  beginning  of  the 
receive  buffer 

Table  2.1-157;  get_receive_buffer  Information. 
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2.1.2.2.1.22  get_s  size.c 

(./simne^lease/src/vehicle/libsrc/libcig/get_s_size.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"cig_lo<^.h" 


2.1.2.2.1.22.1  get_send_size 
This  routine  obtains  the  send  buffer  size. 


Table  2.1-158:  get_send_size  Information. 


2.1.2.2.1.23  not_prep_buf.c 

(,/sunnet/release/src/vehicle/libsrc/libcig/not_prep_buf.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"cig_local.h" 


2.1.2.2.1.23.1  cig_not_ok_to_prepare_buffer 

This  routine  determines  if  the  buffer  should  be  prepared  (i.e.,  if  the  CIG  is  being  used)  by 
checking  the  using_£raphics  flag.  This  routine  is  used  for  debugging  purposes. 


Table  2.1-159:  cig_not_ok_to_prepare_buffer  Information. 
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2.1.2.2.1.24  not_proc_buf.c 

(7simnet/tBlease/src/vehicle/Ubsrc/libcig/not4)roc_buf.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

”sim_cig_if.h" 

”cig_local.h" 


2.1.2.2.1.24.1  cig_not_ok_to_process_buffe  r 

This  routine  detennines  if  the  buffer  should  be  processed  (i-e.,  if  the  CIG  is  being  used)  by 
checking  the  usingjgraphics  flag.  This  routine  is  used  for  debugging  purposes. 


1  Return  Values  1 

Return  Value 

Meanina 

FALSE 

int 

CIG  is  beina  used 

TRUE 

int 

CIG  is  not  beina  used 

Table  2.1*160:  cig_not_ok_to_process_buffer  Information. 


2.1.2.2.1.25  send_status.c 

(./sinine^lease/src/vehicle/libsn^bcig/send_status.c) 

Includes  "libcig.h" 

Buffer  Declaration: 
send_status 

This  file  contains  routines  for  communicating  cig_send  completion  status  between  the 
invoker  of  a  send  to  the  CIG(s)  and  net_simul  (who  must  determine  if  the  send  has 
completed  before  beginning  to  build  a  new  CIG  buffer). 


2.1.2.2.1.25.1  get_send_status 

This  routine  determines  the  status  of  the  send  buffer  (i.e.,  complete  or  pending). 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

send_status 

int 

the  status  of  the  send  buffer 
(either  complete  or  pending) 

Table  2.1*161:  get_send_status  Information. 
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2.1.2.2.1.25.2  set_send_status 
This  routine  sets  the  status  of  the  send  buffer  to  s. 


1  Parameters  I 

1  Parameter 

Tvoe 

Where  Typedef  Declared 

b _ _ _ 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

send_status  -  s 

int 

the  status  of  the  send  buffer 
(either  compiete  or  pendina) 

Table  2.1>162:  set  send  status  Information. 


2.1.2.2.1.26  set_cig  dev.c 

(7sinmet^ease/src/vehicle/libsrc/libcig/set_cig_dev.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns,h" 

"cig_local.h" 


2.1.2.2.1.26.1  set_cig_dev 

This  routine  sets  the  device  number  for  each  CIG.  cig  num  is  the  CIG  being  set  (either 
CIGl  or  CIG2)  and  devjium  is  the  device  number  being  assigned  to  it. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ciQ  num 

int 

Standard 

dev  num 

int 

Standard 

Table  2.1>163:  set_cig_dev  Information. 
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» 


2.1.2.2.1.27  seM_sizes.c 

(./simneiAelease/src/vehicle/libsrc/libcig/set_i_sizes.c) 


Includes: 

"st<iio.h" 

"sim_types.h" 

"sim_inacros.h 

''cig_local.h" 


II 


2.1.2.2.1.27.1  seMnitial_sizes 

This  routine  allows  the  initial  transfer  size  to  be  specified  for  the  send  and  receive  buffers 
via  DRl  1  transfer.  init_send  is  the  initial  transfer  size  of  the  send  buffer,  and  init  recv  is 
the  initial  transfer  size  of  the  receive  bu^er.  The  default  sizes  are  both  S 12. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

init  send 

int 

Standard 

init  recv 

int 

Standard 

Errors 

Error 

Reason  for  Error 

stderr 

•  Exceeded  max  possible  send  initializations 

•  Exceeded  max  possible  recv  initializations 

Table  2.1-164:  set_initial_sizes  Information. 

2.1.2.2.1.28  set_my  if.c 

(7sin:met/r^ease/src/vehicle/libsrc/libcig/set_my_if,c) 


Includes: 

"stdio.h" 

"sim_types.h 

"cig_local.h" 


fi 


2.1.2.2.1.28.1  set_my_if 

This  routine  sets  the  interface  number  to  i  num. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

i  num 

int 

Standard 

Table  2.1-165:  set_my_if  Information. 
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2.1.2.2.1.29  set_req  recv.c 

(ysimnet^Tease/srq/vehicle/libsrc/libcig/set_req_recv.c) 


Includes: 

"stdio.h” 

"sim_types.h 

"cig_locd.h" 


ti 


2.1.2.2.1.29.1  set_request_recei  ve_size 

This  routine  sets  the  receive  buffer  size  to  the  value  in  req_size. 


1  Parameters  1 

1  Parameter 

Type 

Where  Tvpedef  Declared 

int 

Standard 

Table  2.1-166:  set_request_receive_size  Information. 


2.1.2.2.1.30  set_req  send.c 

(ysirrmet/rcTease/src/vehicle/libsrc/libcig/set_req_send.c) 


Includes: 

"stdio.h" 
"sim  types.h 
"cig_local.h" 


II 


2.1.2.2.1.30.1  set_request_send_size 

This  routine  sets  the  send  buffer  size  to  the  value  in  req  size. 


1  Parameters  I 

1  Parameter 

Where  Typedef  Declared 

int 

Standard 

Table  2.1-167:  set_request_send_size  Information. 
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2.1.2.2.1.31  set_s  flag.c 

(./sinMie^lease/src/vehicle/libsrc/libcig/set_s_flag.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

'’cig_local.h" 


2.1.2.2.1.31.1  set_use_requested_flag 

This  routine  allows  the  boolean  status  of  use_requested_sizes  to  be  changed.  If  bool  =  1, 
the  transfer  size  will  be  the  size  requested  in  either  set_request_send  sizeQ  or 
set_request_receive_size();  otherwise,  the  transfer  size  equalslhe  initial  size. 


Table  2.1-168:  set_use_requested_flag  Information. 


2.1.2.2.1.32  setup  buf.c 

(7simnet^lease/src/vehicle/libsrc/libcig/setup_buf-c) 

Includes: 

"stdio.h" 

"sim_dfns.h" 

"mass.stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 

"gbuffer.h" 

"cig_buffer.h" 

"cig_local.h" 

Defines: 

OTHERVEH.OFFSET 
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2.1.2.2.1.32.1  setup_buffer_ptrs 

This  routine  sets  up  the  following  fixed  buffer  pointers  in  s  bufi  start_of_send_buffer, 
end_of_send_buffer,  and  other_start_of_send_buffer.  num  specifies  the  buffer,  and  buf 
points  to  the  beginning  of  the  buffer. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

num 

int 

Standard 

buf 

pointer  to  char 

Standard 

1  1 

Internal 

Variables 

Variable 

Type 

Where  Typedef  Declared 

s  buf 

reaister  pointer  to  S  BUFFER 

Section  2.1.2.2.2.117 

Calls 

Function 

Where  Described 

aet  init  ptrs 

Section  2.1.2.2.2.33.1 

Table  2.1-169:  setup_buffer_ptrs  Information. 


2.1.2.2.1.33  cig_get  db.c 

(./simnet/n^ease/src/vehicle/libsrc/libcig/cig_get_db.c) 

Inlcudes  "cig_local.h" 


2.1.2.2.1.33.1  cig_get_db 

This  routine  returns  a  pointer  to  the  start  of  the  database  name. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

database  name 

pointer  to  char 

the  database  name 

Table  2.1-170: 


cig_get_db  Information. 
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2. 1.2. 2. 2  libmsg 

(ysimnet^lease/sicA'ehicle/libsrc/libmsg  [libmsg]) 

Libmsg  contains  the  routines  that  are  called  when  information  is  being  formatted  in  the 
buffer  for  transfer  to  the  CIG. 


2. 1.2. 2. 2.1  add__veh2cig.c 

(ysimnet/release/src/vehicle/libsrc/libmsg/add_veh2cig.c) 

The  routine  in  this  file  adds  a  dynamic  vehicle  to  the  CIG  buffer. 

Includes; 

"stdio.h’* 

”sim_dfns.h" 

”sim_macros.h" 

"sim_types.h" 

"sines.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubveh.h" 

"Ubrva.h" 

"Ubmsg.h" 

"Ubmap.h" 
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2. 1.2. 2. 2. 1.1  add_veh_to_cig_msg 

This  routine  adds  a  dynamic  vehicle  to  the  CIG  buffer,  where  r  is  a  pointer  to  an  entry  in 
the  RVA  table.  It  returns  TRUE  if  the  vehicle  has  been  added  and  returns  FALSE 
otherwise. 


1  Parameters  I 

1  Parameter 

Type 

Where  Typedef  Declared 

L _ _ _ 

pointer  to  RVA  ENTRY 

libnra.h 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

1 

1  II  III!  — — 

Standard 

mp 

pointer  to 

MAG  OTHERVEH  STATE 

sim_cig_if.h 

from 

reaister  pointer  to  float 

Standard 

to 

reaister  pointer  to  REAL  4 

mass  stdc.h 

sine  Dtr 

reaister  pointer  to  float 

Standard 

sin  cos  index 

int 

Standard 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

int 

vehicle  added 

FALSE 

int 

can't  add  vehicle 

1  Calls  1 

Function 

Where  Described 

append_otherJn_send_ 

buffer 

Section  2.1.2.2.2.13.1 

network  oet  vehicle  force 

Section  2.1.1.3.1.17.1 

man  net  to  cia 

Section  2.6.11.5.7 

SINES  SHII^  INDEX 

Appendix  A  sines.h  (macro  definition) 

add_veh_to_cig_msg  Information. 


Table  2,1-171: 
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2. 1.2. 2. 2. 2  adj_chg  stat.c 

(ysininet/telease/src/vehicle/libsrc/libmsg/adj_chg_stat.c) 

This  file  contains  routines  which  are  used  to  modify  the  static  vehicle  information  in  the 

CIG  buffer. 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

•‘Ubveh.h'* 

"Ubrva.h" 

"libmsg.h" 

•'Ubmap.h" 

"pro_sim.h" 

"msg_loc.h" 


2. 1.2. 2. 2. 2.1  f in_changed_static_remove_msg 

This  routine  fills  the  Static  Vehicle  Remove  message,  which  informs  the  CIG  of  which 
static  vehicles  to  remove  finom  the  display,  mpha  pointer  to  the  Static  Vehicle  Remove 
message,  and  pkt  is  a  pointer  to  the  Vehicle  Appearance  Variant 


1  Parameters  I 

Parameter 

Type 

Where  Typedet  Declared 

mp 

pointer  to 

MSG  STATICVEH  REM 

sim.ciQLit.h 

pkt 

pointer  to 

Vehicle  AppearanceVariant 

p_sim.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedet  Declared 

from 

reaister  pointer  to  REAL 

Sim  tvpes.h 

to 

reaister  pointer  to  REAL  4 

mass  stdc.h 

r  pkt 

pointer  to  RVA  ENTRY 

librva.h 

Calls 

Function 

Where  Described 

network  aet  vehicle  force 

Section  2.1.1.3.1.17.1 

map  net_to  cia 

Section  2.6.11.5.7 

Table  2.1>172:  fill_changed_static_remove_msg  Information. 
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2. 1.2. 2. 2. 2. 2  fill_changed_static_msg 


This  routine  fills  the  Static  Vehicle  State  message,  is  a  pointer  to  the  Static  Vehicle 

State  message,  and  pkt  is  a  pointer  to  the  Vehicle  Appearance  Variant. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mp 

pointer  to 

MSG  STATICVEH  STATE 

sim_cigLifh 

pkt 

pointer  to 

Vehicle  AooearanceVariant 

p_sim.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

from 

reaister  pointer  to  REAL 

Sim  tvpes.h 

to 

reoister  pointer  to  REAL  4 

mass  stdc.h 

r  Dkt 

pointer  to  RVA  ENTRY 

libnra.h 

Calls 

Function 

Where  Described 

network  aet  vehicle  force 

Section  2.1.1.3.1.17.1 

mao  format  asid 

Section  2.6.11.4.6 

mao  net  to  cio 

Section  2.6.11.5.7 

Table  2.1-173:  fill_changed_statlc_msg  Information. 
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2. 1.2. 2. 2. 2. 3  cig_adjust_for_changed_stati cveh 

Information  about  static  vehicles  is  sent  to  the  CIG  when  they  first  enter  the  viewing  range. 
Static  vehicles  are  destroyed  or  restored  to  health  periodically  throughout  the  simulation. 
This  routine  allocates  buffer  space  and  fills  in  the  appropriate  information  for  the  static 
vehicles  which  have  changed  in  appearance. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

veh  listn 

pointer  to  RVA  ENTRY 

librva.h 

num  vehs 

Int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

pkt 

pointer  to 

VehicleAppearanceVariant 

p_sim.h 

mp_rem 

register  pointer  to 

MSG  STATICVEH  REM 

sim_cigLif.h 

mp_add 

register  pointer  to 

MSG  STATICVEH  STATE 

sim_cigLif.h 

k 

register  int 

Standard 

r  Dkt 

pointer  to  RVA  ENTRY 

librva.h 

Calls 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2.2.2.83.1 

fill  changed  static  remove 
msg 

Section  2.1.2.2.2.2.1 

fill  chanced  static  msc 

Section  2.1.2.2.2.2.2 

deallocate jsrepended.buffer 
space 

Section  2.1.2.2.2.26.1 

Table  2.1-174: 


cig_adjust_for_changed_staticveh  Information. 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2. 1.2. 2. 2. 3  adj_otherveh.c 

(ysimnetA«lease/srcA'ehicle/libsrc/libmsg/adj_otherveh,c) 


Includes; 

"stdio.h" 

"inass_stdc.h’’ 

"sim_types.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubveh.h" 

"Ubrva.h" 

"gbuffer.h" 

"pro_siiiLh" 


2. 1.2. 2. 2. 3.1  cig_msg_adj  ust_ot  herveh_state 

This  routine  adjusts  the  Other  Vehicle  State  n^ssage.  Information  about  the  location  of 
dynamic  vehicles  is  sent  to  the  CIG  every  franw.  num  vehs  is  the  number  of  dynamic 
vehicles  which  exist  in  the  CIG  buffer,  and  veh  jist  is  a  pointer  to  the  RVA  list  which 
ctmtains  vehicle  location  information. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

veh  listn 

pointer  to  RVA  ENTRY 

librva.h 

num  vehs 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

pkt 

pointer  to 

VehicieADoearanceVariant 

p_sim.h 

from 

reaister  pointer  to  REAL 

Sim  types. h 

k 

reaister  int 

Standard 

to 

reaister  pointer  to  REAL  4 

mass  stdc.h 

Table  2.1-175;  cig_msg_adjust_otherveh_state  Information. 
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2. 1.2. 2. 2. 4  app_end.c 

(ysimnetAelease/src/vehicle/libsrc/libmsg/app_end.c) 


Includes: 

”stdio.h" 

"sim_macros.h" 

"sim_dfns.h" 

"inass_stdc.h" 

"siip_types.h" 

"dgi_stdg.h" 

"siin_cig_if.h" 

"gbuffenh" 

"msg_loc.h" 


2. 1.2. 2. 2. 4.1  cig_insg_append_end 

This  routine  appends  an  end  message  to  the  QG  buffer.  This  message  has  no  body.  It 
consists  of  a  message  header  only.  Room  should  be  left  in  the  message  buffer  for  ^e  end 
message.  This  routine  obtains  its  own  space  from  the  buffer  because  the  routine 
appCTd_insg_hdrO  always  reserves  room  for  an  M_END,  even  if  the  message  which  is 
being  appended  is  an  end  message. 


1  internal  Variables  I 

1  Internal  Variable 

Where  Tvpedef  Declared 

m _ _ _ 

reaisteroointertoMSG  HDR 

Sim  cia  if.h 

1  Calls  1 

Function 

Where  Described 

aet  send  size 

Section  2.1.2.2.1.22.1 

REPORT  ERROR 

abuffer.h  (macro  definition) 

Table  2.1-176:  cig_msg_append_end  Information. 
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2. 1.2. 2. 2. 5  app_msg_hdr.c 

(ysimnet/rel^e/src/vehicle/libsrc/libmsg/app_msg_hdr.c) 

The  routine  in  this  file  appends  the  message  header. 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

’'dgi_stdg.h" 

"sim_cig_if.h" 

"gbuffer.h" 

"msg_loc.h" 

2. 1.2. 2. 2. 5.1  append_msg_hdr 

This  routine  is  called  to  request  the  next  piece  of  memory  on  the  bottom  of  the  current 
buffer.  If  there  is  enough  memoiy  available,  it  allocates  length  bytes  of  space,  plus  a 
message  header  which  will  be  formatted  to  specify  the  type  of  the  message.  If  this  routine 
is  unsuccessful,  it  returns  NULL;  otherwise,  it  returns  a  pointer  to  the  memory  that  tiie 
caller  should  use  for  the  message. 

This  routine  checks  two  different  pointers  to  determine  if  there  is  still  enough  of  the  buffer 
available.  It  first  checks  the  bottom  of  the  total  buffer  allocated  (end_of_send_buffer)  to 
ensure  that  there  is  enough  room  for  the  MSG_HDR  that  will  be  used  for  the  MSG_END. 
It  also  checks  against  the  current  top  of  the  send  buffer  (front_of_send_buffer)  to  ensure 
that  there  will  hie  space  for  both  the  MSGS_BLK  header  and  the  MSG_HDR  that  will  be 
used  for  the  MSG_END. 


Parameters 


Parameter 


type 


length 


Type 


int 


int 


Where  Tvpedef  Declared 


Standard 


Standard 


Internal  Variables 


Internal  Variable 


hp 


Type 


re2ister£ointerj|oMS^HDR 


Where  Typedef  Declared 


sirt^igJUi^ 


Return  Values 


Return  Value 


NULL 


8_buffer_ptrs[buf_num].back 

^|^en^buffeMen2th 


Type 


pointer  to  char 


pointer  to  char 


Meaning 


invalid  message  type; 
not  enough  space  in  the 
message  buffer 


pointer  to  memory  that  should 
be  used  for  the  message 


Function 


get  send  size 


ERROR  REPORT 


Calls 


Where  Described 


Section  2.1.2.2.1.22.1 


gbuffer.h  (macro  definition) 


Table  2.1-177:  append_message_hdr  Information. 
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2. 1.2. 2. 2. 6  app_intra_ent.c 

(ysimnet/release/src/vehiclc/libsrc/libmsg/app_mtra_ent.c) 


Incliules: 

"stdio.h" 

"sinutypes.h" 

”mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h” 

"libmsg.h" 


2. 1.2. 2. 2. 6.1  multi_clg_append_traj_entry_xfer 

This  routine  appends  the  Trajectory  Entry  Transfer  message  to  the  back  of  the  message 
buffer.  This  routine  is  used  for  a  system  with  two  CIGs. 

The  parameters  are  defined  as  follows: 
birfjnask  -  indicates  CIG  buffer. 

borejc  -  the  X-coordinate  of  the  trajectory  with  respect  to  the  gun  barrel. 

borejs  -  the  2^cooidinate  of  the  trajectory  with  respect  to  the  gun  barrel. 


1  Parameters  I 

Parameter 

Tvdo 

Where  Tvoedef  Declared 

but  mask 

int 

Standard 

bore  X 

REAL 

bore  z 

REAL 

Sim  tvoes.h  1 

1  Calls  1 

Function 

Where  Described 

cig_msg_append_traLentry_ 

xfer 

Section  2.1.2.2.2.10.1 

Table  2.1-178;  multi_cig_append_traj_entry_xfer  Information. 
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2. 1.2. 2. 2. 7  app_intra_tbl.c 

(./simnet/release/src/vehicle/libsrc/libmsg/app_mtra_tbl.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h" 

•'Ubmsg.h'* 

2. 1.2. 2. 2. 7.1  multi_cig_append_t  raj_table_xfer 

This  routine  appends  the  Trajectory  Table  Transfer  message  to  the  back  of  the  message 
buffer.  This  routine  is  only  called  for  a  system  with  two  CIGs. 

The  parameters  are  defined  as  follows: 

bitfjnask  -  indicates  CIG  buffer. 

ammo  type  -  the  ammunition  type  to  be  modeled. 

trajjnd^  -  the  trajectory  table  number,  which  specifies  a  given  trajectory  table. 

count  -  the  size  of  the  trajectory  table. 


Parameters 


Parameter 


but  mask 


ammo  tvoe 


index 


count 


Where  Typedef  Declared 


Standard 


Standard 


Standard 


Standard 


Function 


cig_msg_append_trai_table_ 

xfer 


Calls 


Where  Described 


Section  2.1.2.2.2.11.1 


Table  2.1-179:  muUi_cig_append_traj_table_xfer  Information. 
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2. 1.2. 2. 2. 8  app_stat_rin.c 

(ysiinnetAielease/src/vehicle/libsrc/libmsg/app_stat_rm.c) 


Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_inacros.h 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"Ubveh.h" 

"pio_sim.h" 

"Ubrva.h" 

"libmsg.h" 

"insg_loc.h" 

"libmap.h" 


ti 


2. 1.2. 2. 2. 8.1  cig_msg_append_staticveh_rem 

This  routine  appends  the  Static  Vehicle  Remove  message  to  the  end  of  the  message  buffer. 
vehjist  is  a  pointer  to  the  Vehicle  Appearance  Variant,  which  contains  information  on  the 
appearance  and  location  of  the  vehicle.  The  number  of  static  vehicles  to  be  removed  is 
indented  by  num  vehs. 


1  Parameters  I 

Parameter 

EITimHHiiHiiH 

Where  Typedef  Declared 

vehjist 

pointer  to 

VehicleAppearanceVariant 

p_sim.h 

num  vehs 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

pkt 

pointer  to 

VehicleAppearanceVariant 

p_sim.h 

mp 

register  pointer  to 

MSG  STATICVEH  REM 

sim_cigLif.h 

k 

register  int 

Standard 

from 

register  pointer  to  REAL 

Sim  tvpes.h 

to 

register  pointer  to  REAL  4 

mass  stdc.h 

1  Calls  1 

Function 

Where  Described 

network  aet  vehicle  force 

Section  2.1.1.3.1.17.1 

mao  net  to  cio 

Section  2.6.11.5.7 

aooend  msa  hdr 

Section  2.1.2.2.2.5.1 

Table  2.1-180:  cig_msg_append_staticveh_rem  Information. 
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2. 1.2. 2. 2. 9  app_stat_veh.c 

(7simnet/release/src/vehicle/libsrc/libmsg/app_stat_veh.c) 


Includes: 

"stdio.h" 

"sim_dfns..h" 

"sim_macros.h 

''sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

’'sim_cig_if.h" 

"Ubveh.h" 

"pro_sim.h" 

"sil»va.h" 

"libmsg.h" 

"nisg_loc.h" 

"Ubmap.h" 


It 


2. 1.2. 2. 2. 9.1  cig_msg_a  ppend_static  veh_state 

This  routine  appends  the  Static  Vehicle  State  message  to  the  end  of  the  message  buffer. 
vehjist  is  a  pointer  to  the  Vehicle  Appearance  Variant,  which  contains  information  on  the 
appearance  and  location  of  the  vehicles.  The  number  of  static  vehicles  in  the  buffer  is 
indicated  by  num_vehs. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

vehjist 

pointer  to 

VehicleAppearanceVariant 

p_sim.h 

num  vehs 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Tvoedef  Declared 

pkt 

pointer  to 

VehicleAppearanceVariant 

p_sim.h 

mp 

register  pointer  to 

MSG  STATICVEH  REM 

sim_cigLif.h 

k 

Standard 

from 

register  pointer  to  REAL 

Sim  types.h 

to 

register  pointer  to  REAL  4 

mass,  stdc.h 

1  Calls  1 

Function 

Where  Described 

network  aet  vehicle  force 

Section  2.1.1.3.1.17.1 

mao  net  to  cio 

Section  2.6.11.5.7 

mao  format  asid 

Section  2.6.11.4.6 

aooend  messaoe  hdr 

Section  2.1.2.2.2.5.1 

Table  2.1>181:  cig_msg_append_staticveh_state  Information. 
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2.1.2.2.2.10  app_traj_ent.c 

(7siinnetAclease/src/vehicle/libsic/libinsg/app_traj_ent.c 

Includes: 

**stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg,h" 

''sim_cig_if.h" 

"Ubmsg.h" 


2.1.2.2.2.10.1  cig_insg_append_traj_entry_xfer 


This  routine  appends  the  Trajectory  Entry  Transfer  message  to  the  end  of  the  CIG  buffer. 
The  X-cooidinate  of  the  trajectory  with  respect  to  the  gun  barrel  is  represented  by  bore  x. 
The  Z-coordinate  of  the  trajectory  with  res^t  to  the  gun  barrel  is  represented  by  bore_z. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

bore  X 

REAL 

Sim  tvpes.h 

bore  z 

REAL 

Sim  tvpes.h 

Internal  Variables 

Internal  Variable 

Where  Tvpedef  Declared 

mpto 

register  pointer  to 

MSG  TRAJ  ENTRY  XFER 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

append  messaae  hdr 

Section  2.1.2.2.2.5.1 

Table  2.1>182:  cig_msg_append_traj_entry_xfer  Information. 


I 
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2.1.2.2.2.11  app_traj_tbl.c 

(ysimnetAelease/src/vehicle/libsrc/libmsg/app_traj_tbl.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"inass_st(ic.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 


2.1.2.2.2.11.1  cig_msg_append_traj_table_xfer 

This  routine  appends  the  Trajectory  Table  Transfer  message  to  the  end  of  the  message 
buffer. 

The  parameters  represent  information  that  is  to  be  added  to  the  message  buffer,  and  are 
defined  as  follows: 

ammojype  -  the  ammunition  type  to  be  modeled. 
trajjnd^  -  the  trajectory  table  number. 

count  -  the  size  of  the  trajectory  table. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

ammo  tvoe 

int 

Standard 

trai  index 

int 

Standard 

count 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Tvoedef  Declared 

mp 

register  pointer  to 

MSG  TRAJ  TABLE  XFER 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

append  message  hdr 

Section  2.1.2.2.2.5.1 

Table  2.1-183: 


cig_msg_append_traj_table_xfer  Information. 
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2.1.2.2.2.12  app_vflags.c 

(ysiinnetAelease/src/vehicle/libsic/libmsg/app_vflags.c) 

Includes: 

"stdio.h" 

”sim_types.h" 

"inass_stdc.h" 

"dgi_stdcg.h" 

"sim_cig_if.h" 

"Ubvflags.h" 

'’libmsg.h" 

"libmsg.h" 

"insg_loc.h" 


2.1.2.2.2.12.1  cig_msg_append_view_flags 

This  routine  appends  the  View  Flags  message  to  the  back  of  the  CIG  buffer.  The 
parameters  represent  information  that  is  to  te  added  to  the  message  buffer,  and  are  defined 
as  follows; 

view  Jlags  -  values  that  turn  on  or  off  individual  processing  paths  in  the  CIG 

system. 

branch  values  -  an  array  of  values  that  control  the  branching  of  branch  nodes. 

Configuration  branch  nodes  use  values  from  this  array  to  determine 
which  branch  to  take.  These  values  are  compared  against  the  branch 
mask  specified  in  the  Create  Configuration  Node  message.  Only  the 
lower  24  bits  of  each  branch  value  are  used  in  the  expression. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

view  flaas 

WORD 

mass  stdc.h 

branch  value 

WORD 

mass.stdc.h 

Internal  Variables 

Internal  Variable 

Where  Tvoedef  Declared 

mp 

register  pointer  to 

MSG  VIEW  FLAGS 

sim_cig.h 

1  Calls  1 

Function 

Where  Described 

aoDend  msa  hdr 

Section  2.1.2.2.2.5.1 

Table  2.1-184:  cig_nisg_append_view_flags  Information. 
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2.1.2.2.2.13  append  other.c 

(ysimnetAi3easc/sK^vehicle/libsrc/libmsg/append_other.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"gbuffer.h" 

"msg_loc,h" 


2.1.2.2.2.13.1  append_other_in_send_buffer 

This  routine  appends  an  Other  Vehicle  State  message  to  the  message  buffer.  Space  is 
allocated  and  the  information  is  provided  for  a  new  dynamic  vehicle.  The  pointer  hp  points 
to  the  message  header. 


1  Internal  Variables  I 

internal  Variable 

Type 

Where  Typedef  Declared 

i!B 

reaister  pointer  to  MSG  HDR 

Sim  ciQ  if.h 

Return  Values 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  char 

back  not  equal  to  other.back 
out  of  space 

8_bu1fer_ptrs[01.other_back_ 
in  send  buffer- 
sizeof(MSG  OTHERVEH 
STATE) 

pointer  to  char 

the  location  of  the  Other 

Vehicle  State  message  in  the 
buffer 

Calls 

Function 

Where  Described 

ERROR  REPORT 

abuffer.h  (macro  definition) 

Table  2.1-185:  append_other_in_send_buffer  Information. 


2.1.2.2.2.14  bali_buffer.c 

(ysimnet/release/src/vehicl^bsrc/libmsg/balLbufFer.c) 

This  file  contains  routines  which  create  temporary  buffer  space.  Sending  a  CIG  buffer 
takes  longer  than  a  single  fiiame;  therefore,  the  actual  simulation  fiame  is  overlapped  with 
sending  die  CIG  buffer  from  the  previous  frame.  It  is  necessary  to  create  some  temporary 
buffer  space  for  the  trajectory  chord  messages  and  the  round  fired  messages  that  have  been 
generate  before  the  previous  buffer  has  bwn  fully  transferred.  The  maximum  number  of 
ballistics  messages  that  can  be  sent  are  four  trajectory  chord  messages  and  one  round  fired 
message. 

This  file  was  originally  intended  for  ballistics  messages.  It  is  now  used  for  any 
information  that  is  queued  up  for  the  CIG  outside  of  cig_prepare_buffer(). 
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Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

”dgi_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"if_ctas.h" 

’’gbuffer.h" 

"nasg_loc.h" 

The  following  is  defined: 

BALL_BUFFER_SIZE 

The  following  is  declared:  _ 

ballistics_buffer[BALL_BUFFER_SIZE] 


2.1.2.2.2.14.1  init_balli  stics_buf fer 

This  routine  initializes  the  ballistics  buffer. 


2.1.2.2.2.14.2  copy_ballistics_buffer 

This  routine  copies  the  temporary  ballistics  buffer  to  the  CIG  buffer.  It  assumes  that,  since 
there  can  be  more  than  one  CIG  buffer,  all  buffers  would  want  to  be  aware  of  Ae  ballistics 
messages;  Aerefore,  it  copies  Ae  ballistics  infonnation  mto  Ae  buffer  associated  wiA 
CIG  1.  It  also  assumes  Aat  Aere  is  enough  space  in  Ae  CIG  buffer  to  accomplish  this 
task,  because  it  is  done  very  early  in  cig_prepare_bufrer().  NoAmg  has  been 
prepended  at  Ais  pomt,  so  there  a^I  always  be  enough  room  for  Ae  ballistics  messages. 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

COPY  Size 

int 

Standard 

Table  2.1-186:  copy_ballistics_buffer  Information. 
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2.1.2.2.2.14.3  store_traj_chord 

This  routine  adds  the  trajectory  chord  data  to  the  ballistics  buffer.  The  parameters  represent 
information  that  will  be  placed  in  the  message  buffer,  and  are  defined  as  follows; 

-  the  chord  type,  genei^ly  representing  an  ammunition  or  missile 
type. 

-  an  identifier  for  the  chord. 

-  a  value  of  zero  will  prevent  a  tracer  from  being  displayed;  otherwise, 
the  value  represents  the  effect  type,  to  be  displayed  as  a  tracer. 

-  the  X-,  Y-,  and  Z-coordinates  describing  the  starting  position  of  the 
chord. 

-  the  X-,  Y-,  and  Z-coordinates  describing  the  ending  position  of  the 
chord. 


1  Parameters  I 

1  Parameter 

Type 

Where  Typedef  Declared 

int 

Standard 

ikJ 

int 

Standard 

■  tracer 

BOOLEAN 

Sim  tvpes.h 

VECTOR 

Sim  tvpes.h 

lend 

VECTOR 

Sim  tvpes.h 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

hp 

reaister  pointer  to  MSG  HDR 

Sim  cia  if.h 

mp 

register  pointer  to 

MSG  TRAJ  CHORD 

sim_cigLifh 

time  count 

static  int 

Standard 

1  Calls  1 

Function 

Where  Described 

ERROR  REPORT 

Qbuffer.h  (macro  definition) 

type 

id 

tracer 

begin 

end 


Table  2.1-187:  store_traj_chord  Information. 
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2.1.2.2.2.14.4  store_round_fired 

This  routine  stores  process  round  data  in  the  ballistics  buffer.  The  parameters  represent 
information  that  will  be  stored  in  the  buffer,  and  are  defined  as  follows: 
type 
tracer 


id 

gunpos 

gunvel 

sinelv 

coselv 

sinazm 

cosazm 

estjmpactjime 

estjmpact_range 


round  type;  specifies  tl%  trajectory  table  to  use. 

A  value  of  0  will  cause  the  tracer  effect  type  in  the  trajectory  table 
specified  by  round  type  to  be  displayed  as  the  tracer,  otherwise,  a 
(Cerent,  valid  tracer  effect  must  be  specified, 
unique  round  identifier. 

the  position  of  the  gun  tip,  in  world  coordinates,  at  the  time  of 
firing. 

the  elevation  of  the  gun,  in  world  coordinates,  at  the  time  of  firing, 
the  sine  of  the  gun  elevation  angle,  in  world  coordinates,  at  the  time 
of  firing. 

the  cosine  of  the  gun  elevation  angle,  in  world  coordinates,  at  the 
time  of  firing. 

the  sine  of  the  gun  azimuth  angle,  in  world  coordinates,  at  the  time 
of  firing. 

the  cosine  of  the  gun  azimuth  angle,  in  world  coordinates,  at  the 
time  of  firing, 
estimated  impact  time, 
estimated  impact  range. 


1  Parameters  I 

1  Parameter 

Type 

Where  Typedef  Declared 

int 

Standard 

tracer 

int 

Standard 

id 

int 

Standard 

VECTOR 

Sim  tvpes.h 

aunvel 

VECTOR 

Sim  tvpes.h 

sinelv 

REAL 

Sim  tvpes.h 

ooselv 

REAL 

Sim  tvpes.h 

sinazm 

REAL 

Sim  tvpes.h 

oosazm 

REAL 

Sim  tvpes.h 

est  impact  time 

REAL 

Sim  tvpes.h 

est  impact  ranae 

REAL 

Sim  tvpes.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

hp 

reaister  pointer  to  MSG  HDR 

Sim  cig  if.h 

mp 

register  pointer  to 

MSG  PROCESS  ROUND 

sim_cigLifh 

1  Calls  1 

1  Function 

Where  Described 

1  REPORT  ERROR 

gbuffer.h  (macro  definition) 

Table  2.1-188:  store_round_fired  Information. 
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2.1.2.2.2.14.5  store_view_magnification 

This  routine  stores  magnified  view  data  in  the  temporary  buffer.  The  parameters  represent 
information  that  will  be  stored  in  the  buffer,  and  are  de^ed  as  follows: 
nodejndex  -  the  configuration  node  id  to  which  the  viewport  is  attached. 

lodjnultiplier  -  the  level-of-detail  multiplier,  it  adjusts  the  level  of  detail  range. 

I  -  speciHes  the  horizontal  field  of  view,  in  degrees. 

j  -  specifies  the  vertical  field  of  view,  in  degrees. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

node  index 

HWORO 

mass  stdc.h 

lod  multiplier 

REAL  4 

mass  stdc.h 

1 

REAL  4 

mass  stdc.h 

j 

REAL  4 

mass  stdc.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

hp 

reoister  pointer  to  MSG  HDR 

Sim  ciQ  if.h 

mp 

register  pointer  to 

MSG  VIEW  MAGNIFICATION 

sim_cig_if.h 

Calls 

Function 

Where  Described 

REPORT  ERROR 

abuffer.h  (macro  definition) 

Table  2.1«189:  store_view_magnincation  Information. 


2.1.2.2.2.14.6  store_other_veh_state 

This  routine  creates  an  Other  Vehicle  State  message  in  the  temporary  message  buffer.  It  is 
a  debugging  tool  for  the  etas  head  /engine  tracker  and  is  not  us^  in  this  version  of  the 
code. 


2.1.2.2.2.14.7  store_ctas_init_sta  rtup_model 

This  routine  is  not  implemented  in  this  version  of  the  software. 


2.1.2.2.2.14.8  store_ctas_grow_model 

This  routine  is  not  implemented  in  this  version  of  the  software. 
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2.1.2.2.2.15  buf_reset.c 

(ysimnet/telease/srcA'ehicle/libsrc/libmsg/buf_resetc) 

This  file  contains  a  routine  which  resets  the  CIG  buffer. 


Includes: 

”sim_types.h'' 

"mass_stdc.h" 

’’dgi_stdg.h" 

"siin_cig_if.h" 

"gbuffer.h" 

"cig_buffer.h" 

"Ubmsg.h" 

”insg_loc.h" 


2.1.2.2.2.15.1  buffer_reset 

This  routine  resets  all  of  the  pointers  to  the  CIG  buffer. 


1  Calls  1 

Function 

Where  Described 

clear  n  mapped 

Section  2.1.2.2.2.20.1 

Table  2.1>190:  buffer_reset  Information. 


2.1.2.2.2.16  buf_setup.c 

(./simnet/tclease/srcyvehicle/libsrc/libmsg/buLsetup.c) 

This  file  contains  a  routine  which  sets  up  the  CIG  buffer. 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"gbuffer.h" 

"cig_buffer.h" 

"Ubmsg.h" 

"msg_loc.h" 


2.1.2.2.2.16.1  buffer_setup 

This  routine  resets  all  of  the  pointers  to  the  CIG  buffer.  It  is  similar  to  bufTer_resetO, 
but  it  allows  the  use  of  the  entire  4k  buffer.  ~ 
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2.1.2.2.2.17  check  all.c 

(7simnet^lease/srcMhicle/libsrc/libmsg/check_all.c) 


Includes: 

"sim_types.h" 

"dgi_st(k.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h’* 

•'gbuffer.h" 

The  following  external  declaration  is  made: 
print_checkb 


2.1.2.2.2.17.1  check_all 

This  routine  is  called  to  check  the  message  buffer.  As  the  buffer  is  checked  to  ensure  valid 
message  tyi«s  and  correct  information,  Ae  messages  are  printed  out.  This  routine  is  used 
as  a  debugging  tool,  mbp  is  a  pointer  to  the  message  buffer,  bnum  is  the  buffer  identiBer. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mbp 

pointer  to  MSGS  BLK 

Sim  ciQ  if.h 

bnum 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

bvtes  done 

int 

Standard 

found  end 

int 

Standard 

hp 

MSG  HDR 

Sim  cia  if.h 

error  found 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

error  Jound 

BOOLEAN 

TRUE  -  an  error  in  the  buffer 
was  found 

FALSE  -  no  error  was  found 

1  Calls  1 

Function 

Where  Described 

DOT 

abuffer.h  (macro  definition) 

Section  2.1.2.2.2.41.1 

Table  2.1-191:  check_all  Information. 
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2.1.2.2.2.18  checkbuffer.c 

(7simnet/release/src/vehiclc/libsrc/libmsg/checkbuffer.c) 


Includes: 

"sim_types.h"  "dgi_stdc.h" 

"dgi_stdg.h"  "sim_cig_if.h" 

"msg_loc.h"  "gbuffer.h" 

"if_ctas.h" 

2.1.2.2.2.18.1  check_buffer 

This  routine  checks  if  a  valid  buffer  is  being  %nt  to  the  CIG.  It  is  called  at  each  frame  and 
verifies  that  the  information  in  the  buffer  agrees  with  the  information  that  is  indicated  in  the 
message  headers.  It  also  checks  to  ensure  that  no  invalid  message  types  are  being  sent.  If 
a  problem  with  the  buffer  is  found,  an  error  message  is  printed,  mbp  is  a  pointer  to  the 
message  buffer,  and  bnum  is  the  buffer  identifier. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mbo 

pointer  ot  MSGS  BLK 

Sim  cia  if.h 

bnum 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

bvtes  done 

int 

Standard 

found  end 

int 

Standard 

hP 

MSG  HOR 

Sim  cia  if.h 

error  found 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

error  Jound 

BOOLEAN 

TRUE  -  an  error  in  the  buffer 
was  found 

FALSE  -  no  error  was  found 

Calls 

Function 

Where  Described 

DOT 

abuffer.h  (macro  definition) 

aet  ballistics  debua 

Sections  2.1.2.2.6.2  and  2.1.2.2.7.2 

print  msa  show  effect 

Section  2.1.2.2.2.56.1 

print  msa  file  descr 

Section  2.1.2.2.2.45.1 

print  msa  file  xfer 

Section  2.1.2.2.2.47.1 

print  msa  staticveh  state 

Section  2.1.2.2.2.58.1 

print  msa  staticveh  rem 

Section  2.1.2.2.2.57.1 

print  msa  process  round 

Section  2.1.2.2.2.54.1 

check  all 

Section  2.1.2.2.2.17.1 

Table  2.1>192:  check  buffer  Information. 
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2.1.2.2.2.18.2  print_insg_pass_on 

This  routine  prints  the  first  six  elements  of  the  Pass  On  message.  It  is  used  as  a  debugging 
tool.  Ap  is  a  pointer  to  the  Pass  On  message,  and  len  is  the  length  of  the  message. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

hp 

pointer  ot  MSG  PASS  ON 

Sim  ciQ  if.h 

len 

HWORD 

mass  stdc.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard 

Table  2.1-193:  print_msg_pass_on  Information. 


2.1.2.2.2.19  cig_flushbuf.c 

(./simnet/release/src/vehicle/libsrc/libmsg/cig_flushbuf.c) 


Includes: 

"stdio.h" 


2.1.2.2.2.19.1  cig_flush_buffer 

This  routine  flushes  the  CIG  buffer. 


1  Calls  1 

Function 

Where  Described 

flush  buffer 

Section  2.1.2.2.2.28.1 

Table  2.1-194:  cig_flush_buffer  Information. 


2.1.2.2.2.20  clr_n_mapped.c 

(./simnetAelease/src/vehicle/Iibsrc/libmsg/clr_n_mapped.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi.stdg.h" 

"sim_cig_if.h" 

"msgjoc.h" 


2.1.2.2.2.20.1  clear_n_mapped 

This  routine  sets  n  mapped  to  0. 
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2.1.2.2.2.21  config_key.c 

(7simnet/release/src/vehicle/libsrc/libmsg/config_key.c) 

Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"config_key.h" 

The  following  static  declarations  are  made: 
cn 
vs 
tt 
IB 
OS 

as 

top_key_list[10] 
node_key_list[12] 
ball_key_list  [10] 
viewport_key_list[  10] 


2.1.2.2.2.21.1  key_lisMnUiaIized 

This  routine  returns  a  flag,  list  jnited,  which  indicates  whether  or  not  the  configuration  tree 
was  initialized. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

listjnited 

int 

TRUE  =  list  was  initialized 
FALSE  =  list  not  initialized 

Table  2.1-195:  keyJisMnitialized  Information. 
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2.1.2.2.2.21.2  keyJisMnit 

This  routine  initializes  the  configuration  tree. 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

cnP 

pointer  to  char 

Standard 

vsP 

pointer  to  char 

Standard 

ttP 

pointer  to  char 

Standard 

teP 

pointer  to  char 

Standard 

osP 

pointer  to  char 

Standard 

asP 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

add  keyword 

Section  2.1.2.2.2.21.3 

Table  2.1-196:  keyJisMnit  Information. 


2.1.2.2.2.21.3  add_keyword 

This  routine  adds  a  node  to  the  configuration  tree.  The  parameters  are  defined  as  follows; 

listP  -  pointer  to  list 

keyword  -  pointer  to  a  keyword 

type  -  variable  type 

ojfset  -  offset 

length  -  length 

state  -  state 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

listP 

pointer  to  KEY_LIST 

Section  2.1.2.2.2.22 
confiQ  key.h 

keyword 

pointer  to  char 

Standard 

int 

Standard 

offset 

int 

Standard 

length 

int 

Standard 

state 

int 

Standard 

Table  2.1-197:  add_keyword  Information. 
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2.1.2.2.2.21.4  lookup_keyword 

This  routine  searches  the  keyword  lists  for  the  keyword.  It  returns  a  pointer  to  the  list 
containing  the  keywork  if  it  finds  a  match;  otherwise,  it  returns  NULL.  The  parameters  are 
defined  as  follows: 

keyword  -  keyword  to  be  matched 

table Jist  -  starting  list 


1  Parameters  ! 

Parameter 

Type 

Where  Typedef  Declared 

keyword 

pointer  to  char 

Standard 

tablejist 

pointer  to  pointer  to 

KEY  LIST 

Section  2.1.2.2.2.22 
confiQ  kev.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

listP 

pointer  to  KEY_LIST 

Section  2.1.2.2.2.22 
confia  kev.h 

Return  Values 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  KEY_LIST 

Section  2.1.2.2.2.22 
confia  kev.h 

listP 

pointer  to  KEY_LIST 

keyword  stnjcture 

Table  2.1>198:  lookup_keyword  Information. 


2.1.2.2.2.22  config^^key.h 

(./simnet^lease/src/vehicle/libsrc/libmsg/config_key.h) 

The  following  constants  are  defined: 

KEY_LIST_HDR 

MAX_KEYWORD_LENGTH 

MAX_INPUT_LENGTH 

TYPE.HWORD 

TYPE.STR 

TYPE.REAL 

TYPE_BYTE 

TYPE.WORD 

TYPE_INT_2 

TYPE_INT_4 

KEY_STATE_INIT 

KEY_STATE_NODE 

KEY_STATE_VIEWPORT 

KEY_STATE_TRAJ_TABLE 

KEY_STATE_TRAJ_ENTRY 

KEY_STATE_OVERLAY 

KEY_STATE_AGL 

The  KEY_LIST  structure  is  defined. 
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The  following  are  declared: 
lookup_keywordO 
key_list_initO 
*top_key_listP 
*node_key_listP 
*viewport_key_listP 
*ball_key_lisd* 
*overlay_key_listP 
♦agl_key_listP 


2.1.2.2.2.23  config_msg.c 

(7sininet^lease/src/vehicle/libsrc/libmsg/config_msg.c) 

Includes; 

"stdio.h" 

"math.h" 

"sini_dfns.h" 

"sim_types,h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubcig.h" 

"Ubrva.h" 

"Ubmsg.h" 

"cig_buffer.h" 

"gbuffer.h" 

"nisg_loc.h" 

The  following  are  declared: 
view_config_file[80] 
traj_config_file[80] 


2.1.2.2.2.23.1  cig_set_view_config_fiIe 

This  routine  sets  the  viewport  configuration  file  name  to  the  file  name  pointed  to  by 
filejiame. 

_ _ Parameters _ _ 

Parameter _ Type  [Where  Typedef  Declared 

£Ointertochar^^^^_^^___ 

Table  2.1-199:  cig_set_view_config_riIe  Information. 
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2.1.2.2.2.23.2  clg_set_t  ra  j_conf ig_f i  le 

This  routine  sets  the  trajectory  configuration  file  name  to  the  name  pointed  to  by  filejiame. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

file  name 

pointer  to  char 

Standard 

Table  2.1>200:  cig_set_traj_config_file  Information. 


2.1.2.2.2.23.3  cig_msg_configure_traj 

This  routine  calls  the  routine  cig  readjconfig  fileQ  to  read  the  trajectory  configuration 
file. 


1  Calls  1 

Function 

Where  Described 

da  read  confiafile 

Section  2.1.2.2.2.24.3 

Table  2.1>201:  cig_msg_configure_traj  Information. 


2.1.2.2.2.23.4  cig_msg_configure_view 

This  routine  calls  flush_buffer()  to  initialize  the  send  buffer.  It  then  calls 
piish_nisg_cig_ctl()  to  append  the  CIG  Control  message  to  the  message  buffer.  The 
routine  cig_read_configfile()  is  called;  the  viewport  confi^ation  file  is  read.  The 
Viewflags  message  is  appended  to  the  CIG  message  buffer  via 
cig  msg_append_viewflags(),  and  buf  num  is  reinitialized  to  0.  The  parameter 
bv^indsx  is  the  identifier  for  the  send  buffer. 


1  Parameters  I 

1  Parameter 

Where  Typedef  Declared 

[but  index 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

other  buf 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

flush  buffer 

Section  2.1.2.2.2.28.1 

push  msQ  ciQ  ctl 

Section  2.1.2.2.2.68.1 

ciQ  read  confiafile 

Section  2.1.2.2.2.24.3 

cig  msa  append  viewflags 

Section  2.1.2.2.2.12.1 

Table  2.1>202:  cig_msg_configure_view  Information. 
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2.1.2.2.2.24  config_read.c 

(ysimnet^lease/src/vehicle/libsrc/libmsg/config_read.c) 

Includes: 

"stdio.h" 

"ctype.h" 

"sim_stdio.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_inacros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"config_key.h" 

"msg_loc.h" 

The  following  are  declared: 

DT 

init 

*baseP 


2.1.2.2.2.24.1  config_pos_init 


This  routine  sets  the  initial  position  of  the  vehicle.  The  parameters  are  defined  as  follows: 
pos  -  initial  position  vector. 

head  -  initial  heading,  in  radians. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

POS 

VECTOR 

Sim  types. h 

head 

REAL 

Sim  types. h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

WORLD  bodv  to  oriain 

VECTOR 

Sim  types. h 

WORLD  oriain  to  body 

VECTOR 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

mat  rot  init 

Section  2  6.2.47.1 

vec  copy 

Section  2.6.2.59.1 

vec  nea 

Section  2.6.2.62.1 

vec  mat  mul 

Section  2.6.2.56.1 

Table  2.1*203:  config_pos_init  Information. 
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2.1.2.2.2.24.2  config_pos_init2 

This  routine  sets  the  initial  position  of  the  vehicle.  The  parameters  are  defined  as  follows: 
pos  -  initial  position  vector. 

rot  -  initial  rotation  matrix. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

DOS 

VECTOR 

Sim  tvpes.h 

rot 

T  MATRIX 

Sim  tvpes.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

WORLD  body  to  oriain 

VECTOR 

Sim  tvpes.h 

WORLD  oriain  to  body 

VECTOR 

Sim  types. h 

Calls 

Function 

Where  Described 

mat  copy 

Section  2.6.2.39.1 

vec  copy 

Section  2.6.2.59.1 

vec  nea 

Section  2.6.2.62.1 

vec  mat  mut 

Section2.6.2.56.1 

Table  2.1<204:  config_pos_init2  Information. 
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2.1.2.2.2.24.3  cig_read_configfile 

This  routine  reads  the  configuration  file  via  read  keyword_data(),  and  processes  the 
cotiHguration  Hie  data  via  process_keyword().  'fhe  param^rs  are  defined  as  follows: 
file  name  -  the  configur^on  file  to  be  read 

corfigjiameP  -  type  of  comfiguration  file  (view  or  trajectory) 


1  Parameters  I 

1  Parameter 

Type 

Where  Typedef  Declared 

Ifile  name 

pointer  to  char 

Standard 

pointer  to  char 

Standard 

Internal  Variables 

internal  Variable 

Type 

Where  Typedef  Declared 

keywordP 

pointer  to  KEY_LIST 

Section  2.1.2.2.2.22 
confia  kev.h 

tablejist[4] 

pointer  to  KEY_LIST 

Section  2.1.2.2.2.22 
confia  key.h 

state 

int 

Standard 

keyword[MAX  KEYWORD  L 
ENGTH1 

char 

Standard 

temolMAX  INPUT  LENGTH! 

char 

Standard 

lineno 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

kev  list  initialized 

Section  2.1.2.2.2.21.1 

lookuD  keyword 

Section  2.1.2.2.2.21.4 

read  kevword  data 

Section  2.1.2.2.2.24.4 

coDv  to  TF1 

Section  2.6.4.21 

orocess  kevword 

Section  2.1.2.2.2.24.5 

Table  2.1>205:  cig_read_conrigfile  Information. 


183 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.1.2.2.2.24.4  read_keyword_data 

This  routine  reads  the  contents  of  the  configuration  file.  The  parameters  are  defined  as 
follows: 

keywordP  -  pointer  to  key  list 

input _str  -  input  line  from  file 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

keywordP 

pointer  to  KEY_LiST 

Section  2.1.2.2.2.22 
confia  kev.h 

input  str 

pointer  to  char 

Standard 

Internal  Variables 

1  Internal  Variable 

Type 

Where  Typedef  Declared 

InumllOl 

int 

Standard 

char 

Standard 

Table  2.1>206:  read_keyword_data  Information. 


2.1.2.2.2.24.5  process_keyword 

This  routine  processes  the  configuration  file  data. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

state 

int 

Standard 

keywordP 

pointer  to  KEY_LiST 

Section  2.1.2.2.2.22 
config  key.h 

table_list[] 

pointer  to  KEY_LiST 

Section  2.1.2.2.2.22 
config  key.h 

1  Return  Values  1 

Return  Value 

Meaning 

keywordP->state 

int 

1  Calls  1 

Function 

Where  Described 

append  msa  hdr 

Section  2.1.2.2.2.5.1 

send  buffer 

Section  2.1.2.2.2.24.6 

Table  2.1-207;  process_keyword  Information. 
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2.1.2.2.2.24.6  send_buffer 

This  routine  sends  the  configuration  buffer  to  the  CIG.  After  the  buffer  has  been  sent,  the 
Simulator  Host  waits  for  an  acknowledgement  that  the  buffer  has  been  received  by  the 
CIG.  After  receiving  a  reply  buffer  from  the  CIG,  the  send  buffer  is  prepared  for  the  next 
message  to  be  sent. 


1  Calls  1 

Function 

Where  Described 

CODY  to  TF1 

Section  2.6.4.2.1 

cio  send  buffer 

Section  2.1.2.2.1.10.1 

cki  receive  buffer 

Section  2.1. 2.2.1. 9.1 

flush  buffer 

Section  2.1.2.2.2.28.1 

Table  2.1-208:  send  buffer  Information. 


2.1.2.2.2.25  dealloc  abuf.c 

(ysimnet/r3ease/src/vehicl^bsrc/libmsg/dealloc_abuf.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

sim_cig_if.h" 

msg_loc.h" 

”msg_loc.h" 


2.1.2.2.2.25.1  deaUocate_appended_buffer_space 

This  routine  deallocates  the  most  recently  acquired  appended  buffer  space.  The  size  of  the 
buffer  space  is  denoted  by  length. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

lenath 

int 

Standard 

Table  2.1-209:  deallocate_appended_buffer_space  Information. 
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2.1.2.2.2.26  dealloc  pbuf.c 

(ysimnetAiSease/src/vehicle/libsrc/libmsg/dealloc_pbuf.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

sim_cig_if.h" 

msg_loc.h" 

"msgjoc.h" 


2.1.2.2.2.26.1  deallocate_prepended_buffer_space 

This  routine  deallocates  the  most  recently  acquired  prepended  buffer  space.  The  size  of  the 
buffer  space  is  denoted  by  length. 

_  Parameters 

Parameter _ Type  I  Where  Typedef  Declared 

length  1  ini  Standard 

Table  2.1-210:  deaIIocate_prepended_buffer_space  Information. 
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2.1.2.2.2.27  del_veh.c 

(./simnetA'elease/sTc/vehicle/libsrc/libmsg/del_veh.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

''dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h" 

"librva.h" 

"gbuffer.h" 

"cig_buffer.h" 


2.1.2.2.2.27.1  deIete_veh_from_cig_msg 

This  routine  deletes  a  vehicle  from  the  CIG  message,  r  del  is  a  pointer  to  the  RVA  entry 
which  indicates  which  vehicle  is  to  be  deleted. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

r  del 

pointer  to  RVA  ENTRY 

libn/a.h 

Internal  Variables 

Internal  Variable 

Where  Tvpedef  Declared 

r  move 

pointer  to  RVA  ENTRY 

librva.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

TRUE 

int 

vehicle  removed 

FALSE 

int 

vehicle  not  removed 

1  Calls  1 

Function 

Where  Described 

REPORT  ERROR 

gbuffer.h  (macro  definition) 

Table  2.1-211:  deIete_veh_from_cig_msg  Information. 


187 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.1.2.2.2.28  flushbuf.c 

(ysimnel/release/src/vehicle/Iibsrc/libmsg/flushbuf.c) 

Includes: 

"stdio.h" 

"sim_typcs.h" 

"mass.stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h" 


2.1.2.2.2.28.1  flush_buffer 

This  routine  is  used  to  initialize  the  send  buffer  for  the  next  message. 


2.1.2.2.2.29  get_back.c 

(ysimnet/release/src/vehicle/libsn^bmsg/get_back.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h" 


2.1.2.2.2.29.1  get_back_of_sen  d_buf  f  er 

This  routine  returns  the  location  of  the  pointer  to  the  back  of  the  send  buffer. 


Parameters 


Parameter 


but  index 


IEi73 


Return  Value 


s_buffer_ptrslbufjndex] 
•back  of  send  buffer 


Where  Tyoedef  Declared 


Standard 


Return  Values 


pointer  to  char 


Meanin 


location  of  the  pointer  to  the 
back  of  the  send  buffer 


Table  2.1-212:  get-back_of_send_buffer  Information. 
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2.1.2.2.2.30  get_cig  mask.c 

(ysimnel/rSease/src/vehicle/Iibsrc/libnisg/get_cig_tnask.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h" 


2.1.2.2.2.30.1  get_cig_inask 

This  routine  returns  the  CIG  mask.  The  CIG  mask  indicates  which  CIGs  exist  in  the 
system. 


1  Return  Values  1 

Return  Value 

Meaning 

cig_mask 

int 

the  CIGs  which  are  present  in 
the  system 

Table  2.1>213:  get_cig_mask  Information. 

2.1.2.2.2.31  get_debug.c 

(./simnet/release/src/vehicle/libsrc/libmsg/get_debug.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msgjoc.h" 


2.1.2.2.2.31.1  get_static_debug 

This  routine  returns  the  value  of  static  debug,  which  indicates  whether  or  not  static  vehicle 
debugging  is  enabled. 


1  Return  values  1 

Return  Value 

Type 

Meaning 

static.debug 

int 

indicates  whether  static 
vehicle  debugging  is 
activated. 

Table  2.1*214:  get_static_debug  Information. 
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2.1.2.2.2.32  get_front.c 

(./simnetAielease/src/vehicle/libsrc/libmsg/get_front.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h" 


2.1.2.2.2.32.1  get_front_of_send__buffer 

This  routine  returns  the  location  of  the  pointer  to  the  front  of  the  send  buffer,  buf  index 
indicates  which  CIG's  send  buffer  is  being  accessed. 


1  Parameters  | 

1  Parameter 

Type 

Where  Typedef  Declared 

Ibuf  index 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

s_buffer_ptrs[bufjndex] 

.front  of  send  buffer 

pointer  to  char 

location  of  the  pointer  to  the 
front  of  the  send  buffer 

Table  2.1*215:  get_front_of_send_buffer  Information. 


2.1.2.2.2.33  get_init_buf.c 

(./simnet/release/src/vehicle/libsrc/libmsg/get_init_buf.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"niass_stdc.h" 

"dgLstdg.h" 

"sim_cig_if.h" 

"msgjoc.h" 

"libmsg.h" 


2.1.2.2.2.33.1  get_init_ptrs 

This  routine  returns  the  initial  locations  of  the  pointers  for  the  CIG  buffer. 


1  Return  Values  I 

Return  Value 

Meaning 

init_ptrs 

pointer  to  S_3UFFER 

initial  location  of  the  pointers 
to  the  CIG  buffer 

Table  2.1*216:  get_init_ptrs  Information. 
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2.1.2.2.2.34  get_n  mapped.c 

(./simne{itelease/src/vehicle/libsrc/libmsg/get_n_mapped.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msgjoc.h" 


2.1.2.2.2.34.1  get_n_inapped 


This  routine  returns  the  number  of  dynamic  vehicles  in  the  CIG  buffer. 


1  Return  Values  I 

Return  Value 

Meaning 

n_mapped 

int 

number  of  dynamic  vehicles  in 
the  CIG  buffer 

Table  2.1-217:  get_n_inapped  Information. 


2.1.2.2.2.35  get_other__st.c 

(./simnetA«lease/src/vehicle/libsrc/libmsg/get_other_st.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cig_if.h" 

"msg_loc.h" 


2.1.2.2.2.35.1  get_ot  her_sta  rt_ln_send_buffer 


This  routine  returns  the  location  of  the  pointer  to  the  other  dynamic  vehicles. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

buf  index 

int 

Standard 

1  Return  Values  I 

Return  Value 

Meaning 

s_buffer j)trs[buf_index] 

•Other  start  in  send  buffer 

pointer  to  char 

location  of  the  pointer  to  the 
other  dynamic  vehicles 

Table  2.1-218:  get_other_start_in_send_buffer  Information. 
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2.1.2.2.2.36  get_sbuffer.c 

(ysimnet/release/src/vehicle/libsrc/libmsg/get_sbuffer.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h" 


2.1.2.2.2.36.1  get_sbuffer 

This  routine  returns  the  buffer  which  contains  the  initial  locations  of  all  of  the  CIG  buffer 
pointers. 

_ _ Return  Values _ _ 

Return  Value _ Type _ Meaning _ 

s_butter_ptrs  pointer  to  S_BUFFER  the  buffer  that  contains  the 

initial  locations  of  all  of  the  CIG 

Table  2.1*219:  get_sbuffer  Information. 


2.1.2.2.2.37  msg_loc.c 

(./siinnet/reIease/src/vehicle/libsrc/libmsg/msg_loc.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"gbuffer.h" 

"Ubrva.h" 

"cig_buffer.h" 

"libmsg.h" 

"msgjoc.h" 

This  routine,  given  a  message  index  into  the  slowly  changing  portion  of  the  message  buffer 
which  holds  descriptions  of  the  visible  remote  mobile  velucles,  indicates  which 
remote_vehicles  table  it  represents. 

map_to_remote_vehicles[MAX_CLOSE_VEHICLESl 

n_mapped 

cig_msg_debug 

The  following  are  declared: 

s_buffer_ptrs[2]  (so  up  to  two  CIGs  can  be  supported) 
init_ptrs[2J  (store  values  for  pointer  initial  values) 

buf_num 
cig_mask; 
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using_bumper_numbers 

using_assymetric 

The  following  pointers  are  used  to  keep  track  of  trajectory  chord  messages  and  round  fired 
messages  which  are  stored  in  a  temporary  buffer  until  they  can  be  copied  into  the  CIG 
buffer. 

*start_of_ballistics_buf  -start  of  allocated  space 

*firont_of_ballistics_buf  -start  of  valid  data 

*end_of_ballistics_buf  -end  of  allocated  space  and  valid  data 


2.1.2.2.2.38  msg_loc.h 

(./simnet/release/src/vehicle/libsrc/libmsg/msg_loc.h) 

Includes: 

"sim_macros.h" 

"cig_buffer.h" 

"pro_sim.h" 

"librva.h" 

"libmsg.h" 

The  following  are  declared  as  external: 
s_buffer_ptrs[] 
cig_msg_debug 

*map_to_remote_vehicles[MAX_CLOSE_VEHICLES] 

n_mapped 

static_debug 

init_ptrs 

buf_num 

ci^mask 

using_bumper_numbers 

using_assymetric 

The  following  external  variables  are  pointers  to  the  temporary  buffer  for  ballistics 
messages: 

*start_of_ballistics_buf 

♦ftont_of_ballistics_buf 

*end_of_ballistics_buf 

The  following  is  defined: 

MSG.LEN 

The  following  macro  is  defined: 
ptr_to_index(p) 
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2.1.2.2.2.40  pr_agl.c 

(7siinnet/release/src/vehicle/libsrc/libmsg/pr_agl.c) 


Includes; 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.40.1  print_msg_agl 

This  routine  prints  the  AGL  Collision  message.  It  is  used  as  a  debugging  tool.  The 
parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


[  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

mo 

pointer  to  MSG  AGL 

Sim  cio  if.h 

length 

int 

Standard 

Table  2.1-220:  print_msg_agl  Information. 


2.1.2.2.2.41  pr_cig_ctl.c 

(./simhe{'release/src/vehicle/libsrc/libmsg/pr_cig_ctl.c) 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgLstdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.41.1  print_msg_cig_ctl 

This  routine  prints  the  CIG  Control  message.  It  is  used  as  a  debugging  tool.  The 
parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

mp 

pointer  to  MSG  CIG  CTL 

Sim  ciQ  if.h 

ienath 

int 

Standard 

Table  2.1-221:  print_msg_cig_ctl  Information. 
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2.1.2.2.2.42  pr_ct  gm.c 

(ysimhet^lease/src/vehicle/libsrc/libnisg/pr_ct_gm.c) 

This  file  is  not  implemented  in  the  Masscomp  or  Butterfly. 


2.1.2.2.2.43  pr_ct  ism.c 

(ysimne{^lease/src/vehicle/libsrc/libmsg^r_ct_ism.c) 

This  file  is  not  implemented  in  the  Masscomp  or  Butterfly. 


2.1.2.2.2.44  pr_end.c 

(ysimhet/rclease/src/vehicle/libsrc/libmsg/pr_end.c) 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.44.1  print_msg_end 

This  routine  prints  an  end  message.  It  is  used  as  a  debugging  tool. 


2.1.2.2.2.45  profile  desc.c 

(./simhetAelease/src/vehicle/libsrc/libmsg/pr_file_desc.c) 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi.stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.45.1  print_msg_file_descr 

This  routine  prints  a  File  Descriptor  message.  It  is  used  as  a  debugging  tool.  The 
parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

mp 

pointer  to  MSG  FILE  DESCR 

Sim  ciq  if.h 

lenath 

int 

Standard 

Table  2.1*222:  print_msg_file_descr  Information. 
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2.1.2.2.2.46  pr_file_stat.c 

(ysimhei/release/src/vehicle/libsrc/[ibmsg/pr_file_stat.c) 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.46.1  print_insg_file_status 

This  routine  prints  a  File  Status  message.  It  is  used  as  a  debugging  tool.  The  parameters 
are  defined  as  follows: 

mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

mp 

pointer  to 

MSG  FILE  STATUS 

sim_cigjf.h 

length 

int 

Standard 

Table  2.1-223:  print_msg_file_status  Information. 


2.1.2.2.2.47  pr_file_xfer.c 

(./simhet/reiease/src/vehicle/libsrc/libmsg/pr_file_xfer.c) 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi.stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.47.1  print_msg_file_xfer 

This  routine  prints  a  File  Transfer  message.  It  is  used  as  a  debugging  tool. 
The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

mp 

pointer  to 

MSG  FILE  TRANSFER 

sim_cig_if.h 

length 

int 

Standard 

Table  2.1-224:  prlnt_msg_rile_xfer  Information. 
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2.1.2.2.2.48  pr_hit.c 

(./sirahet/release/src/vehicle/libsrc/libmsg^r_hit.c) 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.48.1  print_msg_hit 

This  routine  prints  a  Hit  message.  It  is  used  as  a  debugging  tool.  The  parameters  are 
defined  as  follows: 

mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mo 

pointer  to  MSG  HIT 

Sim  cia  if.h 

lenath 

int 

Standard 

Calls 

Function 

Where  Described 

print  R4P3D 

Section  2.6.4.17.1 

Table  2.1*225:  print_msg_hit  Information. 
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2.1.2.2.2.49  pr_hit  rtn.c 

(./simnet^lease/src/vehicle/libsrcAibmsg/pr_hit_rtn.c) 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.49.1  print_insg_hit_return 

This  routine  prints  a  Hit  Return  message.  It  is  used  as  a  debugging  tool.  The  parameters 
are  defined  as  follows: 

mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

mo 

pointer  to  MSG  HIT  RETURN 

Sim  ciQ  if.h 

lenath 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

print  R4P3D 

Section  2.6.4.17.1 

Table  2.1-226:  print_msg_hit_return  Information. 


2.1.2.2.2.50  pr_laser_rtn.c 

(./simhetAelease/src/vehicle/libsrc/libmsg/pr_laser_rtn.c) 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.50.1  print_msg_laser_return 

This  routine  prints  a  Laser  Return  message.  It  is  used  as  a  debugging  tool.  The  parameters 
are  defined  as  follows: 

mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

mp 

pointer  to 

MSG  LASER  RETURN 

sim_cig_if.h 

length 

int 

Standard 

Table  2.1-227:  print_msgjaser_return  Information. 
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2.1.2.2.2.51  pr_loc_terr.c 

(./simnet^lease/src/vehicle/libsrc/libmsg/pr_loc_terr.c) 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.51.1  print_msg_local_terrain 

This  routine  prints  a  Local  Terrain  message.  It  is  used  as  a  debugging  tool. 


The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

mp 

pointer  to 

MSG  LOCAL  TERRAIN 

sim_cig_if.h 

length 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

i 

int 

Standard 

V 

int 

Standard 

poly 

pointer  to  LT  POLY  ENTRY 

Sim  ciQ  if.h 

bvol 

pointer  to  LT  BVOL  ENTRY 

Sim  cio  if.h 

too 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

print  R4P3D 

Section  2.6.4.17.1 

Table  2.1-228:  print_msg_local_terrain  Information. 


199 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.1.2.2.2.52  pr_miss.c 

(./simhet/release/src/vehicle/libsrc/libmsg/pr_miss.c) 

Includes; 

"sim_types.h" 

''mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.52.1  print_msg_miss 

This  routine  prints  a  Miss  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows; 
mp  -  a  pointer  to  the  message  buffer, 

length  -  the  length  of  the  message  to  be  printed. 

Parameters _ _ 

Parameter  I  Type  I  Where  Tvpedef  Declared 


Table  2.1-229:  print_msg_miss  Information. 


Sim  do  H.h 
Standard 


inter  to  MSG  MISS 


lenath 
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2.1.2.2.2.53  pr_otherveh.c 

(./simhei/release/src/vehicle/libsrc/libmsg/pr_otherveh.c) 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.53.1  print_msg_otherveh_state 

This  routine  prints  an  Other  Vehicle  State  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 

_  Parameters 

Parameter _ Type _ Where  Typedef  Declared 

mp  pointer  to  sim_cig_if.h 

_  MSG  OTHERVEH  STATE _ 

length_ int_ Standard  


_ _ Calls _ 

Function  j  Where  Described 

print  TF1  Section  2.6.4.18.1 

Table  2.1-230:  print_msg_otherveh_state  Information. 
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2.1.2.2.2.54  pr_proc  rnd.c 

(ysimhei/reIease/src/vehicle/hbsrc/libmsg/pr_proc_md.c) 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.54.1  print_insg_process_round 

This  routine  prints  a  Process  Round  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 

_  Parameters 

Parameter _ Type _ Where  Typedef  Declared 

mp  pointer  to  sim_cig_if.h 

_ MSG  PROCESS  ROUND _ 

length_ int_ Standard 


_ _ Calls _ 

Function  Where  Described 

print  R4P3D  Section  2.6.4.17.1 

Table  2.1>231:  print_msg_process_round  Information. 


202 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.1.2.2.2.55  pr_rnd_fired.c 

(./simhet/rclease/src/vehicle/libsrc/libmsg/pr_md_fired.c) 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.55.1  print_msg_round_fired 

This  routine  prints  a  Round  Fired  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 

Parameters _ _ 

Parameter  Type  Where  Typedef  Declared 

mp  pointer  to  sim_cig_if.h 

_  MSG  ROUND  FIRED _ 

length_ int_ Standard 


_ _ Calls _ 

Function  [Where  Described 

print_R4P3D  Section  2.6.4.17.1 

Table  2.1*232:  print_msg_round_fired  Information. 


203 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2. 1.2. 2. 2. 5S  pr_rnd_fired.c 

(ysiiruiet/release/sr(Vvehicle/libsrc/libmsg/pr_md_fired.c) 

Includes: 

"sini_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.55.1  print_msg_round_fired 

This  routine  prints  a  Round  Fired  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mp 

pointer  to 

MSG  ROUND  FIRED 

sim_cigjf.h 

lenath 

int 

Standard 

Calls 

Function 

Where  Described 

print  _P4P3D 

Section  2.6.4.17.1 

Table  2.1*232:  print_nisg_round_rired  Information. 
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2.1.2.2.2.56  pr_show_eff.c 

(ysiinhei/rele^/sicA^ehicleAibsrc/libmsg/pr_show_eff.c) 


Includes: 

"sim_types.h" 

"inass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.56.1  print_msg_sho  w_effect 

This  routine  prints  a  Show  Effect  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

mp 

pointer  to 

MSG  SHOW  EFFECT 

sim_cigjf.h 

lenath 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

print  R4P3D 

Section  2.6.4.17.1 

Table  2.1<233:  print_msg_show_effect  Information. 
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2.1.2.2.2.57  pr_staticrem.c 

(ysiirmet/release/src/vehicle/libsrcAibmsg/pr_staticrem.c) 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h” 

"sim_cig_if.h" 


2.1.2.2.2.57.1  print_msg_staticveh_reni 

This  routine  prints  a  Static  Vehicle  Remove  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 

_  Parameters 

Parameter _ Type _ Where  Tvpedef  Declared 

mp  pointer  to  sim_cigLif  .h 

_  MSG  STATICVEH  REM _ 

length  int  Standard 

Table  2.1>234:  print_msg_staticveh__rem  Information. 
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2.1.2.2.2.58  pr_staticveh.c 

(7sirnheiAelease/src/vehicle/libsrc/libmsg/pr_staticveh.c) 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.58.1  print_msg_stat  icveh_state 

This  routine  prints  a  Static  Vehicle  State  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

mp 

pointer  to 

MSG  STATICVEH  STATE 

sim_cigLifh 

lenath 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

print  TF1 

Section  2.6.4.18.1 

print  TF2 

Section  2.6.4.19.1 

Table  2.1>235:  print_msg_staticveh_state  Information. 
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2.1.2.2.2.59  pr_subniode.c 

(./simnet/release/sic/vehicIe/libsrc/libmsg/pr_submode.c) 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.59.1  print_msg_subsys_mode 

This  routine  prints  a  Subsystem  Mode  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  •  the  length  of  the  message  to  be  printed. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

mp 

pointer  to 

MSG  SUBSYS  MODE 

sim_cigjf.h 

lenath 

int 

Standard 

Table  2.1>236:  print_msg_subsys_mode  Information. 

2.1.2.2.2.60  pr_sys_err.c 

(./simhetA«lease/src/vehicle/libsrc/libmsg/pr_sys_err.c) 


Includes: 

”sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.60.1  print_msg_sys_error 

This  routine  prints  a  System  Error  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mp 

pointer  to  MSG  SYS  ERROR 

Sim  cia  if.h 

lenath 

int 

Standard 

Table  2.1-237;  print_msg_sys_error  Information. 
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2.1.2.2.2.61  pr_test_nanie.c 

(ysiinhet/reiease/src/vehicle/libsrcAibmsg/pr_test_name.c) 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

''sim_cig_if.h" 


2.1.2.2.2.61.1  priiit_msg_test_name 

This  routine  prints  a  Test  Name  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows: 
mp  -  a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


Parameter 


length 


Parameters 


Where  Typedef  Declared 


inter  to  MSG  TEST  NAME  sim  cig  if.h 


int  I  Standard 


Function 


rint  R4P3D 


Calls 


Where  Described 


Section  2.6.4.17.1 


Table  2.1>238:  print_msg_test_name  Information. 
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2.1.2.2.2.62  pr_traj  chrd.c 

(ysirimet/TCiease/src/vehicle/libsic/libmsg/pr_traj_chrd.c) 


Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 


2.1.2.2.2.62.1  print_msg_traj_chord 

This  routine  prints  a  Process  Round  message.  It  is  used  as  a  debugging  tool. 

The  parameters  are  defined  as  follows: 
mp  -a  pointer  to  the  message  buffer. 

length  -  the  length  of  the  message  to  be  printed. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

mp 

pointer  to 

MSG  TRAJ  CHORD 

sim_cig_if.h 

lenath 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

print_R4P3D 

Section  2.6.4.17.1 

Table  2.1>239:  pnnt_msg_traj_chord  Information. 


2.1.2.2.2.63  pr_vupdate.c 

(./simnet^elease/src/vehicle/libsrc/libmsg^r_vupdate.c) 

This  file  is  not  implemented  in  the  Masscomp  or  the  Butterfly. 


t 
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2.1.2.2.2.64  pre_lrot.c 

(ysiinnetAelease/srcA'ehicle/libsrc/libmsg/pre_lrot.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"siin_cig_if.h" 

"Ubmsg.h" 


2.1.2.2.2.64.1  cig_insg_prepend_lrotation 

This  routine  prepends  the  1  Rotation  message  to  the  CIG  message  buffer.  The  parameters 
represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as  follows: 
nodejndex  -  the  node  that  will  be  updated  by  the  rotations  in  the  following 
~  parameters. 

rotation  axis  -  the  axis  of  rotation,  using  one  of  the  following  values: 

0  heading 

1  pitch 

2  roU 

rotation  -  the  rotation  in  degrees. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

node  index 

HWORD 

mass  stdc.h 

rotation  axis 

BYTE 

simjypes.h 

rotation 

REAL  4 

mass  stdc.h 

Internal  Variables 

Internal  Variable 

Where  Tvpedef  Declared 

mp 

register  pointer  to 

MSG  1  ROTATION 

sim_cigjf.h 

1  Calls  1 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1>240:  cig_msg_prepend_lrotation  Information. 
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2.1.2.2.2.65  pre_3rot.c 

(7sininet/release/src/vehicle/libsrc/libmsg/pre_3rot.c) 


Includes: 

’’stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 


2.1.2.2.2.65.1  cig_msg_prepend_3rotations 

This  routine  prepends  the  SRotadon  message  to  the  CIG  message  buffer.  The  parameters 
represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as  follows: 
nodejndex  -  the  node  that  will  be  updated  by  the  rotations  in  the  following 

~  parameters. 

heading  -  the  heading,  in  degrees. 

pitch  -  the  pitch,  in  degrees. 

roll  -  the  roll  in,  degrees. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

node  index 

HWORD 

mass  stdc.h 

headina 

REAL  4 

mass  stdc.h 

pitch 

REAL  4 

mass  stdc.h 

roll 

REAL  4 

mass  stdc.h 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  SROTATiONs 

sim_ciQLif.h 

1  Calls  1 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1>241:  cig_msg_prepend_3rotations  Information. 
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2.1.2.2.2.66  pre^agl  set.c 

(ysiinnet^Tease/src/vehicle/libsrc/libmsg/pre_agl_set.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 


I 


2.1.2.2.2.66.1  cig_msg_prepend_agl_setup 

This  routine  prepends  the  AGL  Setup  message  to  the  GIG  message  buffer.  The  parameter 
state  toggles  between  0  and  1.  A  value  of  0  indicates  that  the  AGL  should  not  be  sent,  and 
a  value  of  1  indicates  that  the  AGL  should  be  sent 

Parameters 

Parameter  [Type  [Where  Tvpedef  Declared" 

state_ int_ Standard 


Internal  Variables 

Internal  Variable  [Type  I  Where  Tvpedef  Declared 

mp  register  pointer  to  sim_cig_if.h 

 MSG  AGL  SETUP 


_ _ Calls _ 

Function  Where  Described 

prepend  mso  hdr  I  Section  2.1.2.2.2.83.1 

Table  2.1-242:  cig_msg_prepend_agl_setup  Information. 
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2.1.2.2.2.67  pre_am  dfn.c 

(ysiinnet/reTease/src/vehicle/libsrc/libmsg^)re_am_dfn.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"siin_cig_if.h" 

''Ubmsg.h" 


2.1.2.2.2.67.1  cig_msg_prepend_ammo_den  ne 

This  routine  prepends  the  Ammo  Define  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  acMed  to  the  buffer,  and  are  defined  as 
follows: 

ananoO  -  ammunition  type. 

anvnol  -  ammunition  type. 

ammo2  -  ammunition  type. 

ammo3  -  ammunition  type. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

ammoO 

inr 

Standard 

ammol 

int 

Standard 

ammo2 

int 

Standard 

ammo3 

int 

Standard 

I  Internal  Variables  I 

Internal  Variable 

Tvoe 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  AMMO  DEFINE 

sim_cigLif.h 

1  Calls  1 

Function 

Where  Described 

prepend  msQ  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1>243:  cig_msg_prepend_aammo_define  Information. 
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2.1.2.2.2.68  pre_cig  cti.c 

(ysimnet/reTease/src/vehicle/libsrc/libmsg/pre_cig_ctl.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 


2.1.2.2.2.68.1  cig_msg_prepend_ci  g_ctl 

This  routine  prepends  the  CIG  Control  message  to  the  CIG  message  buffer.  The  parameter 
state  is  a  CIG  control  code  which  corresponds  to  the  following: 

0  Do  Nothing  (NULL) 

1  Prepare  for  Simulation 

2  Run  Simulation  Mode 

5  File  Transfer  Mode 

6  Run  Tests 

7  Stop 

8  Start  CIG  Configuration 

9  Start  2-D  Setup 


1  Parameters  I 

1  Parameter 

Where  Typedef  Declared 

1  state 

int 

Standard 

1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  CIG  CTL 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-244:  cig_msg_prepend_cig_ctl  Information. 


2.1.2.2.2.69  pre_ct_gm.c 

(ysimnet/release/src/vehicle/libsrc/libmsg^re_ct_gm.c) 

This  file  is  not  implemented  in  the  Masscomp  or  the  Butterfly. 


2.1.2.2.2.70  pre_ct_ism.c 

(./simnet^lease/src/vehicle/libsrc/libmsg/pre_ct_ism.c) 

This  file  is  not  implemented  in  the  Masscomp  or  the  Butterfly. 
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2.1.2.2.2.71  pre_drll.c 

(7sininetA«lease/src/vehicle/libsrc/libmsg^re_(ir  1 1  ,c) 


Includes: 

**stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"librnsg-h" 


2.1.2.2.2.71.1  cig_insg_prepen  d_drl  l_pkt_size 


This  routine  prepends  the  DRl  1  Packet  Size  message  to  the  CIG  message  buffer.  The 
parametm  reprint  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows: 

-  size  of  the  DRl  1-W  packet  that  the  simulation  host  sends  to  the  CIG 
at  each  frame. 

-  size  of  the  DRl  1-W  packet  that  the  CIG  sends  to  the  simulation  host 
at  each  frame. 

lt_chunk_size  -  size  of  the  local  terrain  pieces  that  are  sent  from  the  CIG  to  the 

simulation  host  until  the  entire  local  terrain  has  been  sent.  The  value 
must  be  less  than  the  CIG  packet  size  by  at  least  SO  bytes. 

-  the  interval,  in  frames,  between  transmissions  of  local  terrain 


send  size 


recv  size 


Itjnterval 

kwjype 


messages. 

-  the  hardware  type  of  the  CIG. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

send  size 

int 

Standard 

recv  size 

int 

Standard 

lt_  chunk  size 

int 

Standard 

It  interval 

int 

Standard 

int 

Standard 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  DR11  PKT  SIZE 

sim_cig_if.h 

1  Calls  1 

1  Function 

Where  Described 

loreoend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-245:  cig_msg_prepend_drll_pkt_size  Information. 
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2.1.2.2.2.72  pre_file  des.c 

(ysimnet/tclease/src/vehicle/libsrc/libinsg/pre_file_des.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 


2.1.2.2.2.72.1  push_msg_file_descr 

This  routine  prepends  the  File  Descriptor  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  ad^  to  the  buffer,  and  are  defined  as 
follows: 

dbjsize  -  the  size  of  the  file  to  be  transferred,  in  bytes. 

dbjto  -  the  number  that  has  been  assigned  to  the  file  to  be  downloaded  or 

uploaded. 

dbjreq  -  specifies  the  requested  database  operation. 

dbjiame  -  the  name  of  the  file  or  database. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

db  size 

int 

Standard 

db_no 

int 

Standard 

db  req 

Int 

Standard 

db  name 

pointer  to  char 

Standard 

1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  FILE  DESCR 

sim_cigLif.h 

1  Calls  1 

Function 

Where  Described 

prepend  msq  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1>246:  push_msg_file_descr  Information. 
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2.1.2.2.2.73  pre_file  sts.c 

(7simnet/release/src/vehicle/libsrc/libmsg/pre_file_sts.c) 

Includes; 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 

2.1.2.2.2.73.1  push_msg_file_status 

This  routine  prepends  the  File  Status  message  to  the  CIG  message  bu^er.  The  parameters 
represent  information  that  will  be  added  to  £e  buffer,  and  are  defined  as  follows: 
type  -  the  type  of  response  specified. 

abort  descr  no  -  the  abort  code. 
blk_seq_no  -  the  block  response  number. 


Parameter 

im _ 

abort  descr  no 
bik  seono 


Parameters 


Where  Typedef  Declared 

Standard _ 

Standard _ 

Standard 


Internal  Variable 
mp 


Internal  Variables 

Type _ 

register  pointer  to 
MSG  FILE  STATUS 


Where  Typedef  Declared 

sim_cigjf.h 


Function _ 

prepend_msg  hdr 


_ Calls 

Where  Described 

Section  2.1.2.2.2.83.1 


Table  2.1-247:  push_msg_me_status  Information. 
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2.1.2.2.2.74  pre_lile  xfr.c 

(ysinii»et/reiease/src/vehicle/libsrc/libmsg/pre_file_xfT.c) 


Includes: 

”stdio.h" 

"sim_types.h"’ 

"mass_stdc.h.’'' 

"dgi_stdg.h'’ 

"sim_cig_if.li”’ 

"Ubmsg.h" 

"msg_loc.h” 

2.1.2.2.2.74.1  push_msg_file_xfer 

This  routine  prepends  the  File  Transfer  message  to  the  CIG  message  buffer.  The 
parameters  represent  hnformation  that  will  be  added  to  the  buffer  and  are  defined  as  follows; 
type  -  the  type  of  transfer  that  the  block  represents.  1  =  file  block,  2  =  end 

of  file. 

blk  size  -  the  amount,  in  bytes,  of  data  in  this  block. 

blk_seq_no  -  the  block’s  sequence  number  in  the  file  transfer  process. 

(kaa  -  the  data  in  the  file. 


1  Parameters  I 

[Parameter  1 

Type 

Where  Typedef  Declared 

int 

Standard 

bik  size 

int 

Standard 

bik  seq  no 

int 

Standard 

data 

pointer  to  char 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

len 

int 

Standard 

mp 

register  pointer  to 

MSG  FILE  XFER 

sim_cig_il.h 

Calls 

Function 

Where  Described 

oreoend  mso  hdr 

Section  2.1.2.2.2.83.1 

Tabl«  2.1-248:  push_msg_file_xfer  Information. 
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2.1.2.2.2.75  pre_gun_over.c 

(./simnet/release/src/vehicle/libsrc/libnisg/pre_gun_over.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libinsg.h" 


2.1.2.2.2.75.1  cig_msg_prepend_gun_overlay 

This  routine  prepends  the  Gun  Overlay  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  ^ed  to  the  buffer,  and  are  defined  as 


follows: 

type 

-  type  of  vehicle 

lrf_rdy 

-  Ae  ready  indicator 

lifjnal 

-  the  malfunction  indicator 

Irfjnrb 

-  the  multiple  return  indicator 

ammo 

-  ammunition  type 

ItfjngU 

-  laser  range  vdue 

azimuthl] 

-  the  azimuth  digits 

rangeU 

-  the  range  digits 

t_vjntx 

•  gun  barrel  rotation 

1  Parameters  I 

1  Parameter  I 

Where  Typedef  Declared 

int 

Standard 

Irf  rdv 

int 

Standard 

Irf  mal 

int 

Standard 

M  mrb 

int 

Standard 

ammo 

int 

Standard 

Irf  man 

BYTE 

Sim  tvpes.h 

azimuthll 

BYTE 

Sim  types.h 

ranaefl 

BYTE 

Sim  types.h 

t  v_mtx 

pointer  to  TF2 

Sim  ciQ  if.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  GUN  OVERLAY 

sim_cigjf.h 

Function _ 

copy  TF2 _ 

prepend  mso  hdr 


_ Calls 

Where  Described 

Section  2.6.4.6.1 
Section  2.1.2.2.2.83.1 


Table  2.1*249:  cig_msg_prepend_gun_overlay  Information. 
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2.1.2.2.2.76  pre_hprxyzs.c 

(ysininetAelease/srcA^ehicle/libsrc/libmsg/^re_hprxyzs.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h’' 

"sim_cig_if.h" 

"Ubmsg.h" 

"msg_loc.h" 


2.1.2.2.2.76.1  cig_insg_prepend_hprxyzs_matrix 

This  routine  prepends  the  HPRXYZS  Matrix  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows: 

nodejndex  -  the  node  that  will  be  updated  by  the  values  in  the  following 
parameters 

heading  •  the  heading,  in  degrees 

pitch  -  the  pitch,  in  degrees 

roU  -  the  roll,  in  degrees 

translation  -  the  negative  X,  Y,  and  Z  position,  in  meters 

scale  -  reserv^  for  future  expansion 

concat_order[]  -  order  in  which  the  matrices  are  multiplied 


Parameters  I 

Parameter 

Where  Tvpedef  Declared 

node  index 

HWORD 

mass  stdc.h 

heading 

REAL  4 

mass  stdc.h 

Ditch 

REAL  4 

mass  stdc.h 

roll 

REAL  4 

mass  stdc.h 

translation 

pointer  to  R4P3D 

dgi  stdg.h 

scale 

pointer  to  R4P3D 

dgi  stdg.h 

concat  orderfl 

BYTE 

Sim  types. h 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  HPRXYZS  MATRIX 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

Drepend  msq  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-250:  cig_msg_prepend_liprxyzs__matrix  In'ormation. 
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2.1.2.2.2.77  pre_lase_rtn.c 

(ysimnet/release/src/vehicle/libsrc/libmsg/pre_lase_rtn.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h” 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 

"msg_loc.h" 


2.1.2.2.2.77.1  push_msg_laser_return 

This  routine  prepends  the  Laser  Return  message  to  the  CIG  message  buffer.  The  parameter 
zjrange  represents  the  range  of  the  object  (in  meters)  in  the  indica^  pixel.  A  value  of  the 
last  v^dd  return  value  should  be  specified  if  the  object  in  the  indicated  pixel  is  "sky". 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

z  range 

float 

Standard 

Internal  Variables 

Internal  Variable 

Where  Tvpedef  Declared 

mp 

register  pointer  to 

MSG  LASER  RETURN 

sim_cigjf.h 

1  Calls  1 

Function 

Where  Described 

prepend  msg  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1>251:  push_msg_laser_return  Information. 
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2.1.2.2.2.78  pre_mcig_ctl.c 

(7simnetAelea»/src/vehicle/libsrc/libmsg/pre_mcig_ctl.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h” 

"libmsg.h" 


2.1.2.2.2.78.1  multi_cig_push_cig_ctl 


This  routine  prepends  the  CIG  Control  message  to  the  appropriate  CIG  message  buffer. 
The  parameters  represent  information  that  will  be  added  to  tiie  buffer,  and  are  defined  as 
follows: 

birfjnask  -  indicates  CIG  buffer 

state  -  a  CIG  control  code  which  corresponds  to  the  following: 

0  Do  Nothing  (NULL) 

1  Prepare  for  Simulation 

2  Run  Simulation  Mode 

5  File  Transfer  Mode 

6  Run  Tests 

7  Stop 

8  Start  CIG  Configuration 

9  Start  2-D  Setup 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

but  mask 

int 

Standard 

state 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  CIG  CTL 

sim_cigLif.h 

1  Calls  1 

Function 

Where  Described 

cia  push  msQ  ctl 

Section  2.1.2.2.2.68.1 

Table  2.1-252:  inulti_cig_pusli_cig_ctl  Information. 
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2.1.2.2.2.79  pre_indrll.c 

(ysimnet/release/src/vehicle/libsrc/libmsg/pre_nidrl  1  .c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 


2.1.2.2.2.79.1  multi_cig_msg_prepend_dr  ll_pkt_size 

This  routine  prepends  the  DRl  1  Packet  Size  message  to  the  appropriate  CIG  message 
buffer.  The  parameters  represent  informadon  that  will  be  added  to  the  buffer,  and  are 
defined  as  follows: 


bufmask 

send_size 

recvjsize 

It  chunk  size 


Itjnterval 

hw_type 


-  indicates  CIG  buffer 

-  size  of  the  DRl  1-W  packet  that  the  simulation  host  sends  to  the  CIG 
at  each  frame 

-  size  of  the  DRl  1-W  packet  that  the  CIG  sends  to  the  simulation  host 
at  each  frame 

-  size  of  the  local  terrain  pieces  that  are  sent  from  the  CIG  to  the 
simulation  host  until  the  entire  local  terrain  has  been  sent.  The  value 
must  be  less  than  the  CIG  packet  size  by  at  least  50  bytes. 

-  the  interval,  in  frames,  between  transmissions  of  local  terrain 
messages 

-  the  hardware  type  of  the  CIG 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

but  mask 

int 

Standard 

send  size 

int 

Standard 

recv  size 

int 

Standard 

It  chunk  size 

int 

Standard 

It  interval 

int 

Standard 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

cig  msg  prepend  dr1 1  jp)kt_ 
size 

Section  2.1.2.2.2.71.1 

Table  2.1-253:  multi_cig_msg_prepend_drll_pkt_size  Information. 
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2.1.2.2.2.81  pre_mreq_lsr.c 

(7simnet/release/src/vehicle/libsrc/libmsg/pre_mreq_lsr.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

”dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 

"msg_loc.h" 


2.1.2.2.2.81.1  multi_cig_msg_prepend_requestjaser_range 

This  routine  prepends  the  Request  Laser  Range  message  to  the  appropriate  CIG  message 
buffer.  The  parameters  represent  information  that  will  be  added  to  the  buffer,  and  are 
defined  as  follows: 

birfjnask  -  indicates  CIG  buffer 

i  -  pixel  locations  within  the  screen  boundry 

j  -  pixel  locations  within  the  screen  boundry 

id  -  the  id  of  the  laser  request.  This  value  is  returned  with  the  laser 

range. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

but  mask 

int 

Standard 

i 

int 

Standard 

i 

int 

Standard 

id 

int 

Standard 

Calls 

Function 

Where  Described 

cig_msgj)repend_request_ 
laser  range 

Section  2.1.2.2.2.91.1 

Table  2.1-255:  multi_cig_msg_prepend_request_laser_range  Information. 
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2.1.2.2.2.82  pre_inrts4x3.c 

(ysimnet^lease/src/vehicle/Iibsrc/libmsg^re_mrts4x3.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim  cig_if.h" 

'*Ubmsg.h" 

"msg_loc.h" 


2.1.2.2.2.82.1  multi_cig_msg_prepend_rts4x3_mat  r  ix 

This  routine  prepends  the  RTS4X3  Matrix  Message  to  the  appropriate  CIG  message  buffer. 
The  parameters  represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows; 

bufjnask  -  indicates  CIG  buffer. 

nodejndex  -  the  node  that  will  be  updated  by  the  4x3  matrix. 

rotjntx  -  the  transformation  matrix  that  describes  the  location  of  the  vehicle. 

vec  -  X,  Y,  Z  translation  values  that  describe  the  location  of  the  vehicle. 


1  Parameters  I 

Parameter 

Where  Tyoedef  Declared 

but  mask 

int 

Standard 

node  index 

int 

Standard 

rot  mtx 

T  MATRIX 

Sim  types.h 

vec 

VECTOR 

Sim  types.h 

Calls 

Function 

Where  Described 

cig  msq  prepe  nd_rts4x3_ 
matrix 

Section  2.1.2.2.2.94.1 

Table  2.1>256:  multi_cig_msg_prepend_rts4x3_matrix  Information. 
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2.1.2.2.2.83  pre_msg_hdr.c 

(7simnetAelease/src/vehicle/libsrc/libmsg^re_msg_hdr.c) 


Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h 

"sim_types.h" 

"inass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"gbuffer.h" 

"msg_loc.h" 

"libmsg.h" 


ti 


2.1.2.2.2.83.1  prepend_nisg_hdr 

This  routine  is  caUed  to  request  the  next  piece  of  memory  on  the  top  of  the  current  buffer. 

If  there  is  enough  memory  available,  it  allocates  length  bytes  of  space  plus  a  MSG_HDR 
which  will  be  formatted  to  specify  the  passed  type  of  the  message.  If  unsuccessful,  the 
routine  returns  a  NULL  pointer,  otherwise,  it  returns  a  pointer  to  the  memory  that  the  caller 
should  use  for  the  message. 

This  routine  checks  two  pointers  to  determine  if  there  is  still  enough  of  the  buffer  available. 
It  first  checks  the  top  of  the  total  buffer  allocated  (start_of_send_buffer)  leaving  enough 
room  for  the  MSGS_BLK  header.  It  then  checks  against  the  current  bottom  of  the  send 
buffer  (back_of_send_buffer),  leaving  room  for  both  the  MSGS_BLK  header  and  for  the 
MSG_HDR  that  will  be  used  for  the  MSG_END. 


Parameters  I 

1  Parameter  1 

Type 

Where  Typedef  Declared 

int 

Standard 

1  lenath 

int 

Standard 

Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

_ 

register  pointer  to  MSG  HDR 

sim  ciQ  if.h 

Return  Values 

Return  Value 

Meaning 

NULL 

pointer  to  char 

invalid  message  type; 
not  enough  space 

s_buffer_ptrslbuf_num].front 
of  send  buffer-i-8izepf(MSG 
HDR) 

pointer  to  char 

a  pointer  to  space  to  be  used 
by  caller 

1  Calls  1 

Function 

Where  Described 

aet  send  size 

Section  2.1.2.2.1.22.1 

Table  2.1-257:  prepend_msg_hdr  Information. 
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2.1.2.2.2.84  pre_mvflags.c 

(./simnei/telease/src/vehicle/libsrc/libmsg/pre_mvflags.c) 


Includes; 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_ci&_if.h" 

"libmsg.h" 

"msg_loc.h" 


2.1.2.2.2.84.1  multi_cig_msg_prepend_view_nags 

This  routine  prepends  the  View  Flags  message  to  the  appropriate  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows; 

birfjnask  -  indicates  CIG  message  buffer 

viewjlags  -  values  that  turn  on  or  off  individual  processing  paths  in  the  CIG 

system 

branch_yalues  -  an  array  of  values  that  control  the  branching  of  the  branch  nodes. 

Configuration  branch  nodes  use  values  from  this  array  to  determine 
which  branch  to  take.  These  values  are  compared  against  the  branch 
mask  specified  in  the  Create  Ctonfiguration  Node  message. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

buf  mask 

int 

Standard 

view  flaas 

WORD 

mass  stdc.h 

branch  valuefl 

WORD 

mass  stdc.h 

Calls 

Function 

Where  Described 

ciQ  msQ  oreoend  view  fiaas 

Section  2.1.2.2.2.106.1 

Table  2.1-258: 


multi_cig_msg_prepend_view_flags  Information. 
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2.1.2.2.2.85  pre_obscure.c 

(ysiinnet/reIease/src/vehicIe/Iibsrc/Iibmsg/ipre_obscure.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"inass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 


2.1.2.2.2.85.1  cig_nisg_prepend_obscu  re 

This  routine  prepends  the  Obscure  message  to  the  CIG  message  buffer.  The  parameters 

represent  information  that  will  be  added  to  the  buffer,  and  are  deflned  as  follows: 

channel  -  the  viewport  id  to  which  the  effect  will  be  applied. 

texture  -  the  texture  to  be  applied. 

rqteat  -  the  number  of  times  to  repeat  the  texture. 

glare  -  the  amount  of  glare;  values  range  from  0  to  1 5. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

channel 

inr 

Standard 

texture 

int 

Standard 

repeat 

int 

Standard 

glare 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Tvpedef  Declared 

mp 

register  pointer  to 

MSG  OBSCURE 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1>259:  cig_msg_prepend_obscure  Information. 
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2.1.2.2.2.86  pre_overall.c 

(ysininet/release/src/vehicle/libsrc/libmsg/pre_overall.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"gbuffer.h" 

"msg_loc.h" 


2.1.2.2.2.86.1  cig_msg_prepend_overaU_hdr 

This  routine  prepends  the  Overall  Header  message  to  the  CIG  message  buffer,  bitf  jndex 
is  the  buffer  to  which  to  write. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

buf  index 

int 

Standard 

1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

mbD 

register  pointer  to  MSGS  BLK 

Sim  cig  if.h 

I  Calls  1 

Function 

Where  Described 

get  send  size 

Section  2.1.2.2.1.22.1 

REPORT  ERROR 

gbuffer.h  (macro  definition) 

Table  2.1>260:  cig_msg_prepend_overall_hdr  Information. 
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2.1.2.2.2.87  pre_ovr  set.c 

(ysimnetAeIease/src/vehicle/libsrc/libmsg/pre_ovr_set.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi.stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 


2.1.2.2.2.87.1  cig_msg_prepend_overlay_setup 

This  routine  prepends  the  Overlay  Setup  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  atUed  to  the  buffer,  and  are  defined  as 
follows: 

type  -  type  of  overlay  (Ml  or  M2) 

node  -  n^e  id. 

ojfset  -  offset  for  gun  barrel  overlay 


1  Parameters  I 

1  Parameter 

Type 

Where  Tvpedef  Declared 

int 

Standard 

node 

inf 

Standard 

offset 

VECTOR 

Sim  types.h 

1  Internal  Variables  I 

Internal  Variable 

Where  Tvpedef  Declared 

mp 

register  pointer  to 

MSG  OVERLAY  SETUP 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

oreoend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-261:  cig_msg_prepend_overIay_setup  Information. 
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2.1.2.2.2.88  pre_pass_bk.c 

(./sininetAelwse/src/vehicle/libsic/libmsg/pre_pass_bk.c) 


Oncludes: 

"stdio.h" 

"sim_types.h" 

’'inass_stdc.h" 

"dgi_stdg.h" 

”Ubmsg.h" 

"msg_loc.h" 


2.1.2.2.2.88.1  cig_insg_prepen  d__pass_bk 

Uiis  routine  prepends  the  Pass  Back  message  to  the  CIG  message  buffer.  The  parameters 
nepresent  information  that  will  be  added  to  tiie  buffer,  and  are  defined  as  follows: 
siubsysjd  -  the  id  of  the  subsystem  where  the  data  is  to  be  sent. 

stubsys  jnsg  -  the  message  to  be  sent. 

msgjength  -  the  length  of  the  message. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

subsvs  id 

INT  2 

mass  stdc.h 

subsvs  msail 

BYTE 

Sim  types. h 

1  III!  Ill  il  — — 

INT  2 

massstdc.h 

Internal  Variables 

bnternal  Variable 

Where  Tvoedef  Declared 

imp 

register  pointer  to 

MSG  PASS  BACK 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1>262:  cig_msg_prepend_pass_bk  Information. 
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2.1.2.2.2.89  pre_pass_on.c 

(ysimnet/release/src/vehicle/libsrcAibmsg/pre_pass_on.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 

"msg_loc.h" 


2.1.2.2.2.89.1  cig_msg_prepend_pass_on 

This  routine  prepends  the  Pass  On  message  to  the  CIG  message  buffer.  The  parameters 
represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as  follows: 
subsysjd  -  the  id  of  the  subsystem  where  the  data  is  to  be  sent. 

siAsys  msg  -  the  message  to  be  sent. 
msgjength  -  the  length  of  the  message. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

subsvs  id 

int 

Standard 

subsvs  msan 

HWORD 

mass  stdc.h 

msa  lenath 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Tvoedef  Declared 

mp 

register  pointer  to 

MSG  PASS  ON 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1>263:  cig_msg_prepend_pass_on  Information. 


2.1.2.2.2.90  pre_proc_rnd.c 

(7simnet/rel^e/src/vehicle/libsrc/libmsg/pre_proc_md.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 
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2. 1.2.2.2.90. 1  clg_msg_prepend_ballistics_insg 


This  Toudine  prepends  the  Process  Round  message  to  the  CIG  message  buffer.  The 
parametBEs  represent  information  that  will  be  ad^  to  the  buffer,  and  are  defined  as 
fiollows;: 


Wpe 

tiracer 


M 

gsunpos 

gunvel 

siinelv 

coselv 

sinazm 

siosazm 

estjmpaestime 

estjmpacej-ange 


round  type. 

tracer  effect  A  value  of  0  will  cause  the  effect  type  in  the  trajectory 
table  specified  by  round  type  to  be  displayed  as  the  tracer; 
otherwise,  a  valid  tracer  effect  must  be  specified, 
unique  round  identifier. 

the  gun  position,  in  world  coordinates,  at  the  time  of  firing, 
the  gun  elevation,  in  world  coordinates,  at  the  time  of  firing, 
sine  of  the  gun  elevation  angle,  in  world  coordinates,  at  the  time  of 
firing. 

cosine  of  the  gun  elevation  angle,  in  world  coordinates,  at  the  time 
of  firing. 

sine  of  the  gun  azimuth  angle,  in  world  coordinates,  at  the  time  of 
firing. 

cosine  of  the  gun  azimuth  angle,  in  world  coordinates,  at  the  time  of 
firing. 

estimated  impact  time, 
estimated  impact  range. 


Parameters  | 

1  Parameter 

Where  Typedef  Declared 

int 

Standard 

tracer 

int 

Standard 

idi 

int 

Standard 

Qiunpos 

VECTOR 

Sim.  types. h 

cpunvel 

VECTOR 

Sim  types.h 

siinelv 

REAL 

Sim  types.h 

cioselv 

REAL 

Sim  types.h 

siinazm 

REAL 

Sim  types.h 

oosazm 

REAL 

Sim  types.h 

e.'St  impact  time 

REAL 

Sim  types.h 

e;st  impact  range 

REAL 

sim  types.h 

1  Internal  Variables  I 

Internal  Warlable 

Type 

Where  Typedef  Declared 

rmp 

register  pointer  to 

MSG  PROCESS  ROUND 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

ptrepend  tnso  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1>264:  cig_msg_prepend_ballistics_msg  Information. 
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2.1.2.2.2.91  pre_req  Isr.c 

(./simnet/reiease/src/vehicle/libsrc/libmsg4»re_rcq_lsr.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 


2.1.2.2.2.91.1  cig_msg_prepend_request_laser_range 

This  routine  prepends  the  Request  Laser  Range  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows: 

i  -  pixel  locations  within  the  screen  boundry. 

j  -  pixel  locations  within  the  screen  boundry. 

id  -  the  id  of  the  laser  request.  This  value  is  returned  with  the  laser 

range. 


i  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

1 

int 

Standard 

1 

int 

Standard 

id 

int 

Standard 

1  Internal  Variables  I 

Internal  Variable 

Where  Tvoedef  Declared 

mp 

register  pointer  to 

MSG  REQUEST  LASER 
RANGE 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-265:  cig_msg_prepend_requesMaser_range  Information. 


2.1.2.2.2.92  pre_rnd  fir.c 

(./simnet(frelease/src/vehicle/libsrc/libmsg^re_md_fir.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"mass_stdc.h" 

"dgi.stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 
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2.1.2.2.2.92.1  cig_insg_prepend_ballistics_insg 


This  routine  prepends  the  Round  Fired  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows: 


type 

tracer 


id 

guiqjos 

gunvel 

sinelv 

coselv 

sinazm 

cosazm 

estjmpactjime 

estjmpact_range 


round  type. 

tracer  effect  A  value  of  0  will  cause  the  effect  type  in  the  trajectory 
table  specified  by  round  type  to  be  displayed  as  the  tracer; 
otherwise,  a  valid  tracer  effect  must  be  specified, 
unique  round  identifier. 

the  gun  position,  in  world  coordinates,  at  the  time  of  firing, 
the  gun  elevation,  in  world  coordinates,  at  the  time  of  firing, 
sine  of  the  gun  elevation  angle,  in  world  coordinates,  at  the  time  of 
firing. 

cosine  of  the  gun  elevation  angle,  in  world  coordinates,  at  the  time 
of  firing. 

sine  of  the  gun  azimuth  angle,  in  world  coordinates,  at  the  time  of 
firing. 

cosine  of  the  gun  azimuth  angle,  in  world  coordinates,  at  the  time  of 
firing. 

estimated  impact  tin^. 
estimated  impact  range. 


Parameters  I 

[Parameter  1 

Where  Typedef  Declared 

int 

Standard 

tracer 

int 

Standard 

id 

int 

Standard 

VECTOR 

Sim  tvpes.h 

Qunvel 

VECTOR 

Sim  tvoes.h 

sinelv 

REAL 

Sim  tvpes.h 

coseiv 

REAL 

sim  tvpes.h 

sinazm 

REAL 

Sim  tvpes.h 

cosazm 

REAL 

sim  tvpes.h 

est  imoact  time 

REAL 

Sim  tvoes.h 

est  imoact  range 

REAL 

sim  tvpes.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  ROUND  FIRED 

sim_cig_if.h 

1  Calls 

Function 

Where  Described 

oreoend  mso  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1*266:  cig_msg_prepend_ballistics_insg  Information. 
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2.1.2.2.2.93  pre_rot2xl.c 

(ysimnetA«lease/src/vehicle/libsrc/libmsg^re_tot2xl.c) 

Includes: 

"stdio.h" 

"sim.types.h" 

"mass_stdc.h" 

’’dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 


2.1.2.2.2.93.1  cig_msg_prepend_rot2xl_matrix 

This  routine  prepends  the  Rot2xl  Matrix  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows: 

node  index  -  the  value  representing  the  node  that  will  be  updated  by  the  matrix. 

cosjrot  -  the  cosine  of  the  angle  of  rotation. 

sinjrot  -  the  sine  of  the  angle  of  rotation. 

axis  -  the  axis  of  rotation;  it  will  have  one  of  the  following  values: 

0  heading 

1  pitch 

2  roU 


Parameters 


Parameter 


node  index 


cos  rot 


sinjrot 


axis 


Internal  Variable 


mp 


Function 


reoend  mso  hdr 


IBT:! 


e 


HWORD 


REAL  4 


REAL  4 


BYTE 


Internal  Variables 


lElTX 


register  pointer  to 
MSG  ROT2X1  MATRiX 


Where  Tvpedef  Declared 


mass  stdc.h 


mass  stdc.h 


mass  stdc.h 


sim  tvoes.h 


Where  Tvpedef  Declared 


sim_cigLif.h 


Calls 


Where  Described 


Section  2.1.2.2.2.83.1 


Table  2.1>267:  cig_msg_prepend_rot2xl_matrix  Information. 
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2.1.2.2.2.94  pre_rts4x3.c 

(7sininet/ielease/src/vehicle/libsrc/libmsg^rc_rts4x3.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 


2.1.2.2.2.94.1  cig_msg_prepend_rts4x3_matrix 

This  routine  prepends  the  RTS4x3  Matrix  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows: 

nodejndex  -  the  node  that  will  be  up^ted  by  the  4x3  matrix. 

rotjntx  -  the  transformation  matrix  that  describes  the  location  of  the  vehicle. 

vec  -  X,  Y,  Z  translation  values  that  describe  the  location  of  the  vehicle. 


1  Parameters  | 

Parameter 

Where  Tvoedef  Declared 

node  index 

int 

Standard 

rot  mtx 

T  MATRIX 

Sim  tvpes.h 

vec 

VECTOR 

Sim  tvoes.h 

Internal  Variables 

Internal  Variable 

Where  Tvoedef  Declared 

mp 

register  pointer  to 

MSG  ROT4X3  MATRIX 

sim_cigLif.h 

1  Calls  1 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2,2.2.83.1 

Table  2.1-268:  cig_msg_prepend_rts4x3_matrix  Information. 
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2.1.2.2.2.95  pre_scale.c 

(7si!nnei/telease/src/vehicle/libsrc/libmsg/prc_scale.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 


2.1.2.2.2.95.1  cig_msg_prepend_scale 

This  routine  prepends  the  Scale  Message  to  the  CIG  message  buffer.  The  parameters 
represent  information  diat  will  be  added  to  the  buffer,  and  are  defined  as  follows; 
nodejndex  -  the  node  that  will  be  updated  by  the  following  parameter. 
scalep  -  three  values  that  describe  the  new  x-scale,  y-scale,  and  z-scale,  to  be 

placed  in  the  new  HPRXYZS  matrix. 


1  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

node  index 

HWORD 

mass  stdc.h 

scaleo 

pointer  to  R4P3D 

dgi  stdQ.h 

Internal  Variables 

Internal  Variable 

Where  Tvpedef  Declared 

mp 

register  pointer  to 

MSG  SCALE 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

Drepend_msa_  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1>269:  cig_msg_prepend_scale  Information. 
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2.1.2.2.2.96  pre_show_eff.c 

(7simnetAelease/src/vehicle/libsrc/libmsg/pre_show_eff.c) 


Includes: 

"stdio.h" 

"sim_types.h” 

"mass_stdc.h" 

"dgi_stdg.h" 

"siin_cig_if.h" 

"Ubmsg.h" 


2.1.2.2.2.96.1  cig_msg_prepend_show_effect 

This  routine  prepends  the  Show  Effect  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  added  m  the  buffer,  and  are  defined  as 
follows: 

id  -  an  identifier  for  active  effects. 

type  -  the  effect  type. 

i  -  application-specific  identification  data. 


1  Parameters  I 

Parameter 

Tvne 

Where  Typedef  Declared 

id 

int 

Standard 

int 

Standard 

Iti 

pointer  to  R4P3D 

dai  stda.h 

1  Internal  Variables  | 

Internal  Variable 

Where  Tvpedef  Declared 

mp 

register  pointer  to 

MSG  SHOW  EFFECT 

sim_cigLif.h 

1  Calls  1 

Function 

Where  Described 

oreoend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-270:  cig_msg_prepend_show__effect  Information. 
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2.1.2.2.2.97  pre_stat  rm.c 

(ysimnetAeIease/src/vehiclc/libsrc/libmsg^rc_stat_rm.c) 

Includes: 

"stdio-h" 

"sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"inass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

'•Ubveh.h" 

"pro_sim.h" 

"Hbrva.h" 

"Ubmsg.h" 

"msgjoc.h" 

"libmap.h" 


2.1.2.2.2.97.1  cig_msg_pr  epen  d_staticveh_rem 

This  routine  prepends  the  Static  Vehicle  Remove  message  to  the  CIG  message  buffer. 
vehjist  is  a  pointer  to  the  list  of  RVA  entries,  which  contains  information  al^t  the 
location  of  static  vehicles,  and  num  vehs  is  the  number  of  vehicles  that  will  be  removed. 


Parameters 


Parameter 


veh  list 


num  vehs 


Internal  Variable 


vap 


Internal  Variables 


pointer  to 

VehicleAppearanceVariant 


reoister  int 


inter  to  RVA  ENTRY 


register  pointer  to 
MSG  STATICVEH  REM 


register  pointer  to  REAL 


register  pointer  to  REAL  4 


Where  Typedef  Declared 


hbrva.h 


Standard 


Where  Typedef  Declared 


p_sim.h 


Standard 


hbrva.h 


sim_cig_if.h 


sim  tvpes.h 


mass  stdc.h 


Function 


repend  msg  hdr 


network  get  vehicle  force 


map  net  to  c 


Calls 


Where  Described 


Section  2.1.2.2.2.83.1 


Section  2.1.1.3.1.17.1 


Section  2.6.11.5.8 


Table  2.1-271:  cig_msg_prepend_staticveh_rem  Information. 
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2.1.2.2.2.98  pre_stat_veh.c 

(ysimnet/rele^ase/src/vehicle/libsrc/libmsg/pre_stat_veh.c) 


Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h 

"sini_types.h" 

"niass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libveh.h" 

"pro_sim.h" 

"librva.h" 

"libmsg.h" 

"nisg_loc.h" 

"libmap.h" 


2.1.2.2.2.98.1  cig_insg_prepen  d_sta  ticveh_state 

This  routine  prepends  the  Static  Vehicle  State  message  to  the  CIG  message  buffer,  vehjist 
is  a  pointer  to  the  list  of  RVA  entries,  which  contains  information  about  static  vehicles,  and 
nwn_yehs  is  the  number  of  static  vehicles  that  are  to  be  changed. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

veh  listn 

pointer  to  RVA  ENTRY 

librva.h 

num  vehs 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Tvpedef  Declared 

vap 

pointer  to 

VehicleAppearanceVariant 

p_sim.h 

k 

register  int 

Standard 

r  Dkt 

pointer  to  RVA  ENTRY 

librva.h 

mp 

register  pointer  to 

MSG  STATiCVEH  STATE 

sim_cig_if.h 

from 

register  pointer  to  float 

Standard 

to 

register  pointer  to  REAL  4 

mass  stdc.h 

1  Calls  1 

Function 

Where  Described 

prepend  msg  hdr 

Section  2.1.2.2.2.83.1 

network  get  vehicle  force 

Section  2.1.1.3.1.17.1 

mao  format  asid 

Section  2.6.11.4.7 

mao  net  to  cig 

Section  2.6.11.5.8 

Table  2.1-272;  cig_msg_prepend_staticveh_state  Information. 
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2.1.2.2.2.99  pre_subino(le.c 

(ysimnetA«lease/src/vehicle/libsrc/libmsg^re_submode.c) 


This  file  is  not  implemented  in  the  Masscomp  or  Butterfly. 


2.1.2.2.2.100  pre_sys  err.c 

(ysimnetAelease^rc/vehicle/libsrc/libmsg/pre_sys_eiT.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 


2.1.2.2.2.100.1  cig_insg_prepend_sys_error 

This  routine  prepends  the  System  Error  message  to  the  CIG  message  buffer.  The 
parameters  represent  informadon  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows: 

error  jnsg  -  error  message  type 

cig  state  -  CIG  state 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

error  msg 

int 

Standard 

cig  state 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  STATICVEH  REM 

sim_cigjf.h 

1  Calls  1 

Function 

Where  Described 

orepend  msg  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-273;  cig_msg_prepend_sys_error  Information. 
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2.1.2.2.2.101  pre  test_nam.c 

(ysimnet/reIease/^/vehicle/Iibsrc/libmsg/pre_test_nam.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 


2.1.2.2.2.101.1  cig_msg_prepend_test_name 

This  routine  prepends  the  Test  Name  message  to  the  CIG  message  buffer,  testjiumber  is 
the  test  identifier. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

test,  number 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  TEST  NAME 

sim_cigjf.h 

1  Calls  1 

Function 

Where  Described 

orepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1*274:  cig_msg_prepend_test_name  Information. 
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2.1.2.2.2.102  pre  traj_chd.c 

(ysimnet/reiease/sTc/vehicle/libsrc/libmsg/pre_traj_chd.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_<tfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 


2.1.2.2.2.102.1  cig_msg_prepend_traj_chord 


This  routine  prepends  the  Trajectory  Chord  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows: 


type 

id 

tracer 


begin 

end 


the  chord  type;  it  generally  represents  an  ammunition  or  missile 
type. 

an  identifier  for  the  chord. 

effect  type.  A  value  of  0  will  prevent  an  effect  from  being 
displayed;  otherwise,  the  value  represents  the  effect  type  to  be 
displayed  as  the  tracer. 

the  X-,  Y-,  and  Z-coordinates  that  describe  the  starting  position  of 
the  chord. 

the  X-,  Y-,  and  Z-coordinates  that  describe  the  ending  position  of 
the  chord. 


1  Parameters  I 

■  Parameter  1 

Where  Typedef  Declared 

int 

Standard 

id 

int 

Standard 

tracer 

BOOLEAN 

Sim  tvpes.h 

beain 

VECTOR 

Sim  types.h 

end 

VECTOR 

Sim  types.h 

1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  TRAJ  CHORD 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-275:  cig_msg_prepend_traj_chord  Information. 
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2.1.2.2.2.103  pre  traj_ent.c 

(7simnet/reIease/^/vehicleAibsrc/libmsg/pre_traj_entc) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_<tfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 


2.1.2.2.2.103.1  cig_msg_prepend_traj_entry_xfer 

This  routine  prepends  the  Trajectory  Entry  Transfer  message  to  the  CIG  message  buffer. 
The  parameters  represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows: 

borejc  -  the  horizontal  displacement  from  the  gun  tip  of  this  trajectory  entry, 

bore_z  -  the  vertical  displacen^nt  from  the  gun  tip  of  this  trajectory  entry. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

bore  X 

REAL 

Sim  tvpes.h 

bore  z 

REAL 

Sim  tvpes.h 

1  Internal  Variables  I 

Internal  Variable 

Where  Typedet  Declared 

mp 

register  pointer  to 

MSG  TRAJ  ENTRY  XFER 

sim_cigjf.h 

1  Calls  1 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-276:  cig_msg_prepend_traj_entry_xfer  Information. 
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2.1.2.2.2.104  pre  traj_tbl.c 

(ysimnet/release/src/vehicle/libsrc/libmsg/pre_traj_tbl.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 


2.1.2.2.2.104.1  cig_insg_prepend_traj_table_xfer 

This  routine  prepends  the  Trajectory  Table  Transfer  message  to  the  CIG  message  buffer. 
The  parameters  represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows: 

ammojype  -  the  ammunition  type  of  the  tracer  effect  to  be  displayed. 
trajjnd^  -  the  trajectory  table  numbers. 

count  -  size  of  the  trajectory  table. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

ammo  tvoe 

int 

Standard 

trai  index 

int 

Standard 

count 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Tvpedef  Declared 

mp 

register  pointer  to 

MSG  TRAJ  TABLE  XFER 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

orepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-277:  cig_msg_prepend_traj_table_xfer  Information. 
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ParameltM' 


node  indieK 


Internal  writble 


mp 


Functfon 


Parameters 


e 


HWORD 


Internal  Variables 


lETH 


register  pointer  to 
MSG  TRANSLATION 


Where  Tvoedel  Declared 


mass  stdc.h 


i  stdg.h 


Where  Typedef  Declared 


sim_cig_if.h 


Calls 


Where  Described 


Section  2.1.2.2.2.83.1 


Talk  2.1-278:  cig_msg_prepend_update_translation  Information. 
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2.1.2.2.2.106  pre_vflags.c 

(ysininel/release/src/vehicle/libsrc/libmsg4)rc_vflags,c) 


Includes: 

"stdio.h" 

"sim_types.h" 

’'sim_dfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libvflags.h" 

'•Ubmsg.h" 

"msg_loc.h" 


2.1.2.2.2.106.1  cig_msg_prepend_view_flags 

This  routine  prepends  the  View  Flags  message  to  the  CIG  message  buffer.  The  parameters 
represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as  follows: 
view  Jlags  -  values  that  turn  on  or  off  individual  processing  paths  in  the  CIG 

system. 

branch_yalues  -  an  array  of  values  that  control  the  branching  of  the  branch  nodes. 

Configuration  branch  nodes  use  values  from  this  array  to  determine 
which  branch  to  take.  These  values  are  compared  against  the  branch 
mask  specified  in  the  Create  Configuration  Node  message. 


Pararr  eten 


Parameter 

Where  Typedef  Declared 

view  flaas 

WORD 

mass  stdc.h 

branch  values!! 

WORD 

mass  stdc.h 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  VIEW  FLAGS 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

prepend  msa  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-279;  cig_msg_prepend_view_flags  Information. 
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2.1.2.2.2.107  pre^vmag.c 

(./simneiAelease/src/vehicle/libsrc/libnisg^re_vmag.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

''sim_<tfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 


2.1.2.2.2.107.1  cig_msg_prepend_view_magnification 

This  routine  prepends  the  View  Magnification  message  to  the  CIG  message  buffer.  The 
parameters  represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as 
follows: 

nodejndex  -  the  node  that  will  be  updated  by  the  following  parameters. 
lodjnagnifier  -  the  level-of-detail  magnifier, 
i  -  the  horizontal  field  of  view,  in  degrees. 

j  -  the  vertical  field  of  view,  in  degrees. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

node  index 

HWORD 

mass  stdc.h 

lod  maanifier 

REAL  4 

mass,  stdc.h 

1 

REAL  4 

mass  stdc.h 

j 

REAL  4 

mass  stdc.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Tvpedef  Declared 

mp 

register  pointer  to 

MSG  VIEW  MAGNIFICATION 

sim_cigLif.h 

Calls 

Function 

Where  Described 

prepend  mso  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1>280:  cig_msg_prepend_view_magnif1cation  Information. 
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2.1.2.2.2.108  pre_vmode.c 

(ysimnet/release/src/vehicle/libsrc/libmsg/pre_vniode.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_<tfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 

"msg_loc,h" 


2.1.2.2.2.108.1  cig_msg_prepend_view_mode 

This  routine  prepends  the  View  Mode  message  to  the  CIG  message  buffer.  The  parameter 
viewjnode  represents  information  that  will  be  added  to  the  buffer. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

view  mode 

WORD 

mass  stdc.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  VIEW  MODE 

sim_cig_if.h 

1  Calls  1 

Function 

Where  Described 

prepend  msQ  hdr 

Section  2.1.2.2.2.83.1 

Table  2.1-281:  cig_msg_prepend_view_mode  Information. 
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2.1.2.2.2.109  pre  vport.c 

(7simnet/release/sic/vehicle/libsrc/libmsg/pre_vport.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmsg.h" 

2.1.2.2.2.109.1  cig_msg_prepend_viewport_state 

This  routine  prepends  the  Viewport  State  message  to  the  CIG  buffer.  The  parameters 

represent  information  that  will  be  added  to  the  buffer,  and  are  defined  as  follows: 


nodejndex 

viewponid 

datahasejd 

res 

viewing_range 
near _plane 

lodjnagrdfier 

aspea_ratio 

i 

j 


defines  the  node  to  which  the  viewport  is  attached, 
the  id  value  assigned  to  the  viewport, 
the  database  id. 
the  screen  resolution. 

the  distance  that  can  be  viewed  from  the  viewport 

a  value  greater  than  or  equal  to  1  changes  the  near  plane  of  the 

viewport. 

the  level-of-detail  multiplier.  This  value  adjusts  the  level  of  detail 
ranges. 

the  aspect  ratio. 

the  horizontal  field  of  view,  in  degrees, 
the  vertical  field  of  view,  in  degrees. 


Parameter 


node  index 


viewDort  id 


database  id 


res 


viewino  ranae 


near  piane 


lod  maanifier 


aspect  ratio 


Internal  Variable 


mp 


Function 


repend  mso  hdr 


r 


Parameters 


e 


HWORD 


BYTE 


BYTE 


inter  to  RESOLUTION 


REAL  4 


REAL  4 


REAL  4 


REAL  4 


REAL  4 


REAL  4 


lEin 


irs 


Internal  Variables 


lim 


register  pointer  to 
MSG  VIEWPORT  STATE 


Where  Typedef  Declared 


mass  stdc.h 


Sim  tvoes.h 


Sim  tvpes.h 


sim  ciQ  if.h 


mass  stdc.h 


mass  stdc.h 


mass  stdc.h 


mass  stdc.h 


mass  stdc.h 


mass  stdc.h 


Where  Typedef  Declared 


sim_cigLif.h 


Calls 


Where  Described 


Section  2.1.2.2.2.83.1 


Table  2.1-282:  cig_msg_prepend_viewport_state  Information. 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.1.2.2.2.110  pre  vupdate.c 

(ysiinnet/telease/src/vehicle/libsrc/libmsg/pre_vupdate.c) 

This  file  is  not  implemented  in  the  Masscomp  or  Butterfly. 

2.1.2.2.2.111  printbuffer.c 

(7simnet/release/src/vehicle/libsrc/libmsg/printbuffer.c) 

This  file  contains  a  routine  which  prints  the  contents  of  each  message  buffer. 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

”dgi_stdg.h" 

"sim_cig_if.h" 

"gbuffer.h" 


2.1.2.2.2.111.1  print_buffer 

This  routine  prints  the  name  and  contents  of  each  message  in  the  message  buffer.  It  is  used 
as  a  debugging  tool,  mbp  is  a  pointer  to  the  n^ssage  buffer. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mbp 

pointer  to  MSGS  BLK 

Sim  cia  if.h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

bytes  done 

int 

Standard 

bfi _ 

pointer  to  MSG  HDR 

Sim  cia  if.h 

Calls 

Function 

Where  Described 

DOT 

abuffer.h  (macro  definition) 

print  msQ  end 

Section  2.1.2.2.2.44.1 

print  msa  cia  ctl 

Section  2.1.2.2.2.41.1 

print  msQ  other  veh  state 

Section  2.1.2.2.2.53.1 

print  msa  laser  return 

Section  2.1.2.2.2.50.1 

print  msQ  trai  chord 

Section  2.1.2.2.2.62.1 

print  msa  show  effect 

Section  2.1.2.2.2.56.1 

print  msa  local  terrain 

Section  2.1.2.2.2.51.1 

print  msa  test  name 

Section  2.1.2.2.2.61.1 

print  msa  file  descr 

Section  2.1.2.2.2.45.1 

print  msa  file  xfer 

Section  2.1.2.2.2.47.1 

print  msa  file  status 

Section  2.1.2.2.2.46.1 

print  msa  sys  error 

Section  2.1.2.2.2.60.1 

print  msa  staticveh  state 

Section  2.1.2.2.2.58.1 

print  msa  staticveh  rem 

Section  2.1.2.2.2.57.1 

print  msa  round  fired 

Section  2.1.2.2.2.55.1 

print  msa  aal 

Section  2.1.2.2.2.40.1 

Table  2.1>283:  print_buffer  Information. 
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2.1.2.2.2.112  set  assym.c 

(./simnet/release/src/vehicle/libsrc/libmsg/set_assym.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h" 


2.1.2.2.2.112.1  set_assymetric_on 
This  routine  sets  using  assymetric  to  TRUE. 


2.1.2.2.2.113  set_buf  num.c 

(./simnetAelease^rc/vehicle/libsrc/libinsg/set_buf_num.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass  stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msgjoc.h" 


2.1.2.2.2.113.1  set_buffer_iium 
This  routine  sets  the  buffer  number  to  num. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

num 

int 

Standard 

Table  2.1-284:  set_buffer_num  Information. 
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2.1.2.2.2.114  set  cig  mask.c 

(ysimnet/teTease^rc/vehicle/libsrc/libmsg/set_cig_mask.c) 


Includes: 

"stdio.h" 

”sim_types.h" 

"mass_stdc.h" 

”dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h" 


2.1.2.2.2.114.1  set_cig_inask 

This  routine  sets  bit  wise  ORs  num  to  the  current  CIG  mask. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

num 

int 

Standard 

Table  2.1*285:  set_cig_mask  Information. 


2.1.2.2.2.115  set  veh_spec.c 

(ysimnet^lMse/src/vehicle/libsrc/libmsg/set_veh_spec.c) 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"gbuffer.h" 

"cig_buffer.h" 

"Ubmsg.h" 

"msg_loc.h" 


2.1.2.2.2.115.1  cig_set_veh_spec_ptrs 

This  routine  sets  pointers  to  the  location  of  CIG  speciHc  information  in  the  message  buffer. 
This  routine  is  only  called  when  two  CIGs  are  being  used.  It  is  not  implemented  in 
Version  6.6  of  this  code. 
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2.1.2.2.2.116  use  debug. c 

(ysimnetAielease/src/vehicle/libsrc/Iibmsg/use_debug.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"msg_loc.h" 


2.1.2.2.2.116.1  use_static_debug 

This  routine  sets  the  flag  on  such  that  debugging  of  static  vehicles  is  enabled.  It  is  a 
debugging  tool. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

on 

int 

Standard 

Table  2.1>286:  use_static_debug  Information. 


2.1.2.2.2.117  libmsg.h 

(/simnet/release/src/vehicle/libsrc/libmsg/libnisg.h) 

The  following  routines  arc  declarcd  external: 
prepend_msg_hdr() 
deailocaFe_prepended_buffer_space() 
append_msg_hdr() 
deaIlocate_appended_buffer_space() 
push_msg~clg_ctl() 
clg_insg_prepend_ballistics_msg() 
cig_msg3repend3*’aj_chord() 
cig_msg~prepend”eo(r 
cig”msg”prepend”show_effect() 
push_msg_test_nalne() 
cig_insg_appeird_endO 
pu^_msg_laserjreturn() 
push^^msg'hitO” 
push”msg”sys_err() 
push”msg“rtnnt() 
push~msg~file'^descr() 
push”msg”file~xfer() 
push~msg~file~status() 
get_sTaticJdebug() 
use”static~debug() 
cig~msg_a'ppend_staticveh  state() 
cig~msg~append”asid_statrcveh_state() 
cig~append  statlcveh_j*em() 
cig”adjust_Tor_changed_staticveh() 
cig~msg_prep^d_genveh_state() 
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cig_msg_prepend_request_Iaser_range() 

cig~msg~  p  repen  d~pass_on()  ~ 

cig”msg”prepend”pass”back() 

cig~msg~prepend”zoom() 

cig”msg”prepend”viewport_state() 

cig~msg”prepend“view_mode(> 

cig“nisg~prepend”view“  flags() 

cig~nisg~append_view_7lags() 

cig~msg~prepend^view'  magnification() 

cig“nisg”prependjrot23cl_matrix  () 

cig~nisg~prepend~rts4x3”matrix() 

cig”nisg“prepend~hprxyzs_matrix() 

cig~nisg~prepend2update_rranslation() 

cig”nisg~prepend”scale()~ 

cig~nisg~prepend_3rotations() 

cig~msg~prepend_lrotation() 

cig~msg”prepend”gen_configtree() 

cig”msg~prepend”cigjconfig() 

cig~nisgjappend_traj3able_xfer() 

cig~nisg~append~traj~entry“xfer() 

cig'msg”  prepend_agrsetup() 

print_buTfer() 

checl^bufferO 

buffei^resetO 

cig_flush_buffer() 

cig'prepelid  overall_header() 

flusb_buffer7) 

clear^i.mappedO 

get_ri^inapped() 

cig”msg_adjust_otherveh_state() 

ap^endjbther^in__send_bu’ffer() 

add_veH_to  cTgjihsgO 

deIete_veh_7roin_cig_nisg() 

print_msg_agl()  “ 

print”nisg”cig_ctl() 

print_msg~end() 

print~msg_eo() 

print”msg”file_descr() 

print”msg”file”status() 

print~msg”file”xfer() 

print~msg~hit(y 

print”msg_hit_return() 

print”nisg”niiss() 

print  ~msgjaser_return() 

print”nisgJocal~ter  rain  0 


pnnt_msg_m2veh_state() 

print_nisg”myveh_stateO 

print”nisg_otherveh_state() 

print”msg”round_fired() 

print~msg_p  roceM_roun  d  ( ) 

print_nisg2^rtn_lt()  ” 

print”msg~show_effect() 

print3nsg_staticveh_reni() 

print”nisg_sys_error() 
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print_msg_test_name() 
print~msg3*‘aj_chord() 
get_fFon  t  Jbf_seh  d_b  uf fe  r  ( ) 
get__other3start_in“send_buffer() 
get”back3f_sendjbuffer() 
cig'read'configfileO 
cig”insg3**®P®**d_guii_overlay() 
cig_msg3*’®P®n<*'’overiay_setup() 
of_cfgs() 

get_sbuffer(7 

get”init_ptrs() 

buffer_setupO 

cig_set  veh_spec_ptrs() 

set”buffer_nu™()” 

muTti_cig_7nsg_prepend_rts4x3  matrix() 

multrcigZ>nsg“p*‘®P®nd~v»®w_fl®gs() 

multi~pus*>_msg_cig_ctlO 

multi”p“sh”msg~file”descr() 

multl”ig_nisg_ap'pend_end() 

multrdg_n>sg_prepend_pass_on() 

inulti3*gr*nsgjttPP®nd_traJ_t»ble_xfer() 

multi“cig~msg”app®nd3>’ajl®ntry“xf®r() 

set_cig_iriaskO 

get”c>gZ***ask() 

store__round_fi*‘®<l() 

store''traj__chord() 

init_6alli^ics_buff®r() 

copy_baIlistics_buffer() 


The  following  constants  are  defined: 
CIG.NONE 
CIG_1 
C1G_2 
CIG.ALL 


The  structure  S_BUFFER  is  defined. 
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2.1.2.2.3  libproc 

(ysimnet^lease/src/vehicle/libsrc/libproc  [libproc]) 

Libproc  contains  the  routines  that  are  used  to  process  messages  received  from  the  CIG. 


2.1.2.2.3.1  alt^abv  gnd.c 

(ysimnet^lease/src/vehicle/libsrc/libproc/alt_abv_gnd.c) 


Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"proc_loc.h" 


tt 


2. 1.2. 2. 3. 1.1  cig_altitude_above_gnd 

This  routine  returns  the  aldtude  above  ground  from  the  MSG_AGL  CIG  message,  which  is 
returned  by  the  CIG  evety  frame.  The  altitude  above  ground  is  the  height  above  ground  of 
the  vehicle  centroid.  This  data  is  stored  in  libproc  for  access  by  any  of  the  other  software 
modules. 


1  Return  Values  1 

Return  Value 

Meaning 

altitude 

REAL  4 

the  altitude  above  ground 

Table  2.1-287:  cig_aItitude_above_gnd  Information. 
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2.1.2.2.3.2  get_f_status.c 

(ysminet/telease/src/vehicle/libsn^bproc/get_f_status.c) 

Includes; 

"stdio.h" 

"sim_types,h" 

"mass_stdc.h" 

”dgi_stdg.h" 

”sim_cig_if.h" 

"proc_loc.h" 


2. 1.2. 2. 3. 2.1  cig_get_file_stat  us_data 


This  routine  obtains  data  about  the  file  status  by  returning  a  pointer  to  the 
MSG_FILE_STATUS  CIG  naessage.  The  file  status  message  is  processed  in  the  routine 
process_insg_file_status()  in  "proc_f_stat.c". 


1  Internal  Variables  I 

Variable 

Type 

Where  Tvpedef  Declared 

ret 

pointer  to 

MSG  FILE  STATUS 

sim_cig_if.h 

1  Return  Values  1 

Return  Value 

Meanina 

ret 

pointer  to 

MSG  FILE  STATUS 

data  on  the  tile  status 

Table  2.1*288:  clg_get_flle_status_data  Information. 
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2.1.2.2.3.3  get^file  dat.c 

(./sinmet^lease/srcA'ehicle/libsrc/libproc/get_file_(iatc) 


Includes: 

"stdio-h" 

"sim_types.h'' 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"procjoc.h" 


2. 1.2. 2. 3. 3.1  cig_get_file_xfer_data 

This  routine  obtains  data  on  the  file  transfer  by  returning  a  pointer  to  the 
MSG_FILE_XFER  CIG  message.  The  file  transfer  message  is  processed  in  the  routine 
process_msg_file_xfer()  in  "proc_f_stat.c". 


1  internal  Variables  I 

Variable 

Where  Typedef  Declared 

ret 

pointer  to  MSG  FILE  XFER 

Sim  ciQ  if.h 

1  Return  Values  I 

Return  Value 

Meanlnp 

ret 

pointer  to  MSG  FILE  XFER 

data  on  the  file  transfer 

Table  2.1>289:  cig_get_11Ie_xfer__data  Information. 


2.1.2.2.3.4  get_laser.c 

(./simnet/release/src/vehicle/libsrc/libproc/get_laser.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"proc_loc.h" 


2. 1.2. 2. 3. 4.1  cig_laser_range 

This  routine  returns  the  laser  range  value  from  theMSG_LASER_RETURN  CIG  message. 
This  data  is  stored  in  libproc  for  access  by  any  of  the  other  software  modules. 


1  Return  Values  I 

Return  Value 

Meanina 

laser,  ranae  value 

REAL  4 

mass  stdc.h 

Table  2.1*290:  cig_laser_range  Information. 
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2.1.2.2.3.5  geMaser2.c 

(ysininetA«lease/src/vehicle/libsrc/libproc/get_laser2.c) 

Includes; 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"piDc_loc.h" 


2. 1.2. 2. 3. 5.1  cig_laser_range2 

This  routine  returns  the  laser  range  value  from  the  second  CIG  in  a  two-CIG  configuration. 
This  data  is  stored  in  libproc  for  access  by  any  of  the  other  software  modules. 


1  Return  Values  1 

Return  Value 

Meaning 

laser  range  value2 

REAL  4 

mass  stdc.h 

Table  2.1-291:  cig_iaser_range2  Information. 


2.1.2.2.3.6  init_agl  rtn.c 

(./simnet^lease/src/vehicle/libsrc/libproc/init_agLrm.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"procjoc.h" 


2. 1.2. 2. 3. 6.1  cig_init_msg_agl_routine 

This  routine  initializes  the  above  ground  level  routine.  The  routine  takes  i1n()  as  a 
parameter  where  rtn  is  the  name  of  a  function  that  returns  an  integer. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

rtn 

PFI 

Sim  tvpes.h 

Table  2.1-292;  cigJnit_msg_agl_routine  Information. 
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2.1.2.2.3.7  proc_agl.c 

(./sin:me^release/src/vehicle/libsrc/libproc/proc_agl.c) 


Includes: 

"stdio.h" 

"sim_dfns.h" 

”sim_macros.h" 

"sim_types.h" 

"mass_std.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"procjoc.h" 


2. 1.2. 2. 3. 7.1  process_msg_agl 

This  routine  processes  the  MSG.AGL  GIG  message.  It  calls  the  routine  that  was  set  in 
cig_init_insg_agl_routine(),  passing  it  the  variable  altitude,  which  is  the  current 
altimde  idrove'^ound. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

mo 

pointer  to  MSG  AGL 

Sim  cia  if  h 

Table  2.1-293;  proccss_msg_agl  Information. 


2.1.2.2.3.8  proc^buf.c 

(./simnetA«lease/src/vehicIe/libsrc/Iibproc/proc_buf.c) 


Includes: 

"sim_types.h" 

"dgi_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"if_ctas.h" 

"gbuffer.h" 

"procjoc.h" 

"libmsg.h" 

"pro_sim.h" 

External  declarations:  debug 
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2. 1.2. 2. 3. 8.1  process_buffer 


This  routine  steps  through  each  of  the  messages  in  the  CIG  buffer  and  determines  the 
appropriate  processing  for  the  type  of  message. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

mbp 

pointer  to  MSGS  BLK 

Sim  cia  if.h 

buffer  num 

int 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

msa  count 

int 

Standard 

appjakt 

external  pointer  to 
SimulationPDU 

p_sim.h 

bytes  done 

int 

Standard 

bik  size 

int 

Standard 

Calls 

Function 

Where  Described 

BYTE  COUNT 

abuffer.h 

DOT 

abuffer.h 

process  msa  laser  return 

Section  2.1.2.2.3.16.1 

process  msa  svs  error 

Section  2.1.2.2.3.22.1 

is  air  vehicle 

Section  2.6.10.1.1 

process  msa  local  terrain 

Section  2.1.2.2.3.15.1 

process  msa  It  piece 

Section  2.1.2.2.3.19.1 

aet  ballistics  debua 

Section  2.1.2.2.2.44.1 

print  msa  miss 

Section  2.1.2.2.2.52.1 

process  msa  miss 

Section  2.1.2.2.3.20.1 

print  msa  hit  return 

Section  2.1.2.2.2.49.1 

process  msa  hit  return 

Section  2.1.2.2.3.14.1 

process  msa  aal 

Section  2.1. 2.2.3. 7.1 

process  msa  file  descr 

Section  2.1.2.2.3.13.1 

process  msa  file  xfer 

Section  2.1.2.2.3.12.1 

process  msq  file  status 

Section  2.1.2.2.3.11.1 

process  msa  pass  back 

Section  2.1.2.2.3.21 

Table  2.1-294:  process_buffer  Information. 


2.1.2.2.3.9  proc_ct  ram.c 

(./sirnhetJ^elease/src/vehicle/libsrc/libproc/proc_ct_ram.c) 

The  code  in  this  file  is  applicable  only  to  the  GT  machine,  which  is  not  included  with  this 
system. 
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2.1.2.2.3.10  proc_end.c 

(./simnet/release/src/vehicle/libsrc/libproc/proc_en(Lc) 

This  routine  processes  the  end  message  from  the  CIG  buffer.  This  message  serves  as  a 
signal  to  stop  processing  because  the  messages  have  ended. 


2.1.2.2.3.11  proc_f  stat.c 

(ysirmiet^lease/src/vehicle/Iibsrc/libproc/proc_f_stat.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

''dgi_stdg.h" 

"sim_cig_if.h" 

"ptoc_loc.h" 


2.1.2.2.3.11.1  p  rocess_msg_file_status 

This  routine  processes  the  MSG_FILE_STATUS  CIG  message.  This  message  is  used  to 
acknowledge  that  a  block  has  been  received  or  to  request  re-transmission  of  that  block. 
The  routine  saves  a  pointer  to  the  file  status  data.  This  pointer,  mp,  is  only  valid  for  the 
current  frame  and  will  be  rewritten  during  the  next  tick. 

Parameters 

Parameter  [Type  [Where  Tvpedet  Declared 

mp  pointer  to  sim_cig_if.h 

_  MSG  FILE  STATUS _ 

Table  2.1-295:  process_msg_nie_status  Information. 
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2.1.2.2.3.12  proc_f  xfer.c 

(ysimnei;^lease/src/vehicle/libsrc/libproc/proc_f_xfer.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"procjoc.h" 


2.1.2.2.3.12.1  process_msg_file_xfer 

This  routine  processes  the  MSG_FILE_XFER  CIG  message.  This  message  is  used  to 
transfer  files  and  databases.  The  routine  saves  a  pointer  to  the  file  transfer  data.  This 
pointer  is  only  valid  for  the  current  frame  and  will  be  rewritten  during  the  next  tick. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

mo 

pointer  to  MSG  FILE  XFER 

Sim  cia  if.h 

lenath 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Tvoedef  Declared 

bik  size 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

bfk  slze+1 

1  int 

the  bulk  size  of  the  file  transfer 

Table  2.1>296:  process_insg_nie_xfer  Information. 
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2.1.2.2.3.13  proc_fdescr.c 

(7siinnet/release/src/vehicle/libsic/libproc/proc_fdescr.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

”dgi_stdg.h" 

"sim_cig_if.h'’ 


2.1.2.2.3.13.1  process_msg_file_descr 

This  routine  processes  the  MSG_FILE_DESCR  CIG  message.  This  message  contains 
information  about  files  or  databases  that  will  be  transferred.  This  message  is  also  used  to 
provide  a  diiectoiy  listing  to  the  simulation  host,  to  delete  files  firom  the  CIG,  or  to  specify 
the  simulation  dat^ase. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

mp 

pointer  to  MSG  FILE  DESCR 

Sim  ciQ  if.h 

lenath 

int 

Standard 

1  Calls  1 

1  Function 

Where  Described 

1  print  msq  file  descr 

Section  2.1.2.2.2.45.1 

Table  2.1-297:  process_msg_fiIe_descr  Information. 


2.1.2.2.3.14  proc_hit.c 

(./simnet/release/src/vehicle/libsrc/libproc^roc_hit.c) 


Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h 

"sim_types.h" 

"mun_t^.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubmap.h" 

"Ubimps.h" 

"libmatrix.h" 

"libkin.h" 

"UbhulLh" 

"libmissile.h" 

"libnetwork.h" 

"librva.h" 

"procjoc.h" 


If 
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Declarations: 

proc_hit_debug  =  FALSE 


2.1.2.2.3.14.1  process_nisg_hit_return 

This  routine  processes  the  MSG_Hrr_RETURN  CIG  hit  message.  This  message  returns 
ballistics  intersection  information.  Hie  message  contains  information  on  the  type  of 
projectile  that  was  fired  and  the  type  of  object  that  was  stmck. 

For  missile  impacts,  the  routine  determines  whether  the  impact  was  with  the  ground,  with  a 
vehicle  hull  or  turret,  or  with  an  unknown  object.  Ground  impacts  call  the  routine 
inissile_util  comm_intersected_poly()  for  processing.  Vehicle  impacts  call  the 
routine  inissTle_utircomm_inte'rsected_inodel()  for  processing.  Unknown  impacts 
return  an  error  message.  ”  ~ 

For  impacts  other  than  those  of  missiles,  the  routine  detemoines  the  range  and  the  type  of 
impact  Ground  impacts  call  the  routine  network_send_ground_impact().  Vehicle 
impacts  call  the  routine  network_send_vehicle_impactO.  UnkiTown  impacts  return  an 
error  message.  ~ 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  HIT  RETURN 

sim_cigLifh 

lenath 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

d  impact  pt 

VECTOR 

Sim  types.h 

REAL 

sim  types.h 

1  ammo  index  I 

int 

Standard 

liui 

pointer  to  float 

Standard 

chord .  start 

pointer  to  float 

Standard 

chord  end 

pointer  to  float 

Standard 

1  Calls  1 

Function 

Where  Described 

f2d  vec  copy 

Section  2.6.2.19.1 

map  is  missile 

Section  2.6.11.2.15 

missile  util  comm  intersected  poly 

Section  2.5.3.25.4 

missile  util  comm  intersected  model 

Section  2.5.3.25.5 

rva  aet  veh  id 

Section  2.5.12.10.1 

kinematics  ranoe  squared 

Section  2.5.8.10.1 

network  send  around  impact 

Section  2.1.1.3.1.25.1 

impacts  queue  effect 

Section  2.5.15.1.3 

network  send,  vehicle  impact 

Section  2.1.1.3.1.70.1 

Table  2.1-298:  process_msg_hit_return  Information. 
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2.1.2.2.3.14.2 


process_msg_hit 


This  routine  prints  the  statement  "got  a  msg_hit". 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

mo 

register  pointer  to  MSG  HIT 

Sim  cig  if.h 

length 

int 

Standard 

Table  2.1-299:  process_msg_hit  Information. 


2.1.2.2.3.15  proc_l  terr.c 

(ysimnei^lease/src/vehicle/libsrc/libproc/procJ_terr.c) 


Includes; 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"procjoc.h" 

"libveh.h" 

"Ubkin.h" 

"Ubhullh" 


2.1.2.2.3.15.1  process_msgJocal_terrain 

This  routine  processes  the  MSG_LOCAL_TERRAIN  message,  which  is  sent  in  pieces  by 
the  CIG  over  a  series  of  frames  (the  default  is  32  frames).  This  message  contains 
information  that  the  simulation  host  uses  to  determine  the  position  and  orientation  of  the 
simulated  vehicle  and  to  calculate  the  dynamics  of  that  vehicle.  The  routine  first 
preprocesses  the  bvols  and  polys,  and  then  calls  terrain_preproc_terrain(),  located  in 
libterrain.  ~ 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  LOCAL  TERRAIN 

sim_cig_if.h 

length 

int 

Standard 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

DOlV 

pointer  to  LT  POLY  ENTRY 

Sim  cig  if.h 

bvol 

pointer  to  LT  BVOL  ENTRY 

Sim  cig  if.h 

Function _ 

terrain  preproc  terrain 
kinematjc^giet^o^^^ 


Calls _ 

I  Where  Describe 

Section  2.5.1 1.6.1 
Section  2.5.8.2.4 


Table  2.1-300;  process_msg_local_terrain  Information. 
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2.1.2.2.3.16  proc_laser.c 

(./sitnnei/release/src/vehicle/libsrc/libproc/proc_laser.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"niass_stdc.h" 

"dgi_stdg.h" 

"siin_cig_if.h" 

"piocjoc.h" 


2.1.2.2.3.16.1  process_insg_laser_return 

This  routine  processes  the  MSG_LASER_RETURN  message,  which  is  sent  ftom  the  CIG 
every  frame,  liiis  message  contains  laser  range  information  for  the  specified  pixel  within 
the  screen.  The  variable  laser  range j^alue  is  set  from  the  information  passed  in  the 
message.  This  routine  has  the  capability  of  handling  two  CIGs,  although  this  system  only 
includes  one  CIG. 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

mp 

pointer  to 

MSG  LASER  RETURN 

sim_cigLifh 

buffer  num 

int 

Standard 

Table  2.1>301:  process_msgJaser_return  Information. 


2.1.2.2.3.17  procjoc.c 

(./simnet/release/src/vehicle/libsrc/libproc/procjoc.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

''sim_cig.h" 

"procjoc.h" 


Declarations: 

altitude 

nisg_agl_rtn 

laser_range_value 

laser_range_value2 

file_xfer_data 

file_status_data 

lt_buffer[20] 

lt_chunk_size 


This  file  contains  declarations  of  variables. 
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2.1.2.2.3.18  proc_loc.h 

(./simnet/release/src/vehicle/libsrc/libproc/proc_loc.h) 

This  file  contains  declarations  of  variables. 


2.1.2.2.3.19  proc_lt_pi.c 

(7simnet/release/src/vehicle/libsrc/libproc/procJt_pi.c) 


Includes; 

"stdio.h" 
"sim_types.h 
"mass  stdc.h 


M 

II 


"dgi_stdg.h" 

"sim_cig_if.h" 

"procjoc.h" 

"Ubveh.h" 

"libkin.h" 

"libhull.h" 


2.1.2.2.3.19.1  process_msg_I  t_piece 

This  routine  processes  the  MSG_LT_PIECE  message,  which  is  sent  by  the  CIG  once  per 
frame.  The  local  terrain  message  is  divided  into  pieces,  which  are  sent  as 
MSG_LT_PIECEs  at  a  rate  of  one  per  frame.  Once  all  of  the  pieces  have  been  received, 
process_msgJocal_terraln()  is  called  to  process  the  entire  message. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

mp 

register  pointer  to 

MSG  LT  PIECE 

sim_cigjf.h 

lenath 

int 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

ctr 

int 

Standard 

Itp 

pointer  to 

MSG  LOCAL  TERRAIN 

sim_cigjf.h 

chunkp 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

process  msq  local  terrain 

Section  2.1.2.2.3.15.1 

Table  2.1-302:  process_msg_U_piece  Information. 
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2.1.2.2.3.20  proc_miss.c 

(./simnet/release/sic/vehicle/libsrcAibproc^roc_miss.c) 


Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_macros.h 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"pioc_Ioc.h" 

"libmap.h" 

"libnetwork.h" 


(I 


2.1.2.2.3.20.1  process_insg_miss 

This  routine  processes  the  MSG_MISS  CIG  message.  A  miss  occurs  when  a  fired  round 
does  not  hit  anything  (i.e.,  it  passes  out  of  the  range  of  the  terrain  database).  If  the  miss 
was  by  a  missile,  libmissile  processes  the  message;  otherwise,  the  routine 
network_send_non_impact()  is  called  to  process  the  message. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

mp 

pointer  to  MSG.MISS 

Sim  ciq  if.h 

lenpth 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

map  is  missile 

Section  2.6.11.2.15 

network  send  non  impact 

Section  2.1.1.3.1.33.1 

Table  2.1-303:  process_msg_miss  Information. 


2.1.2.2.3.21  proc_pback.c 

(./simriet/rclease/src/vehicle/libsrc/libproc/proc_pback.c) 

The  message  processed  by  this  file  is  not  generated  by  the  CIG  used  in  this  system. 
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2.1.2.2.3.22  proc_sys_err.c 

(./simnet/rel&ase/src/vehicle/libsrc/libproc/proc_sys_err.c) 


Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubcig.h" 


2.1.2.2.3.22.1  process_msg_sys_error 

This  routine  processes  the  MSG_SYS_ERROR  message  from  the  CIG.  The  system  error 
message  is  sent  to  the  simulation  every  frame,  informing  it  of  whether  or  not  an  error 
exists.  This  routine  determines  how  to  process  the  various  types  of  errors. 


1  Parameters  1 

Parameter 

Where  Tyoedef  Declared 

mo 

pointer  to  MSG  SYS  ERROR 

Sim  cig  if.h 

length 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Tyoedef  Declared 

local  int 

int 

Standard 

debuQ 

extern  int 

Standard 

1  Calls  1 

Function 

Where  Described 

ciQ  too  many  vehicles 

Section  2.5.12.28.1 

orint  mso  svs  error 

Section  2.1.2.2.2.60.1 

Table  2.1-304:  process_msg_sys_error  Information. 
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2.1.2.2.3.23  set_c1iunk.c 

(./siinhetAclease/src/vehicle/libsrc/libproc/set_chunk.c) 

Includes: 

"stdio.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig.if.h" 

"procjoc.h" 


2.1.2.2.3.23.1  set_chunk_size 

This  routine  sets  the  size  of  the  piece  (or  chunk)  of  terrain  in  process  msg  It  oieceO, 
which  is  in  "proc_lt_pi.c".  It  may  be  desirable  to  adjust  the  chunk  size  ff  the  CiG  buffer 
size  has  been  changed  from  the  default. 


Parameter 


size 


lEin 


Parameters 


where  Tvoedef  Declared 


Standard 


Return  Value 


size 


lEJTi! 


Return  Values 


Table  2.1-305:  set  chunk  size 


Meanin 


Standard 


'■.rination. 
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2.1.2.2.4  libvflags 

(ysimnet/rclease/src/vehicle/libsrc/libvflags  [libvflags]) 

Information  for  the  view_flags  and  view_modes  messages  is  contained  in  libvflags.  These 
messages  control  which  screens  are  turned  on  and  which  are  blacked  out  as  well  as 
brancl^g  information  for  the  viewport  conflguration  setup.  It  is  sometimes  necessary, 
under  special  circumstances,  to  be  able  to  toggle  bits  on  the  timing  and  control  board  on  the 
QG.  t^s  task  is  also  accomplished  via  the  view.flags  message. 


2.1.2.2.4.1  clr^br_bit.c 

(ysimnetAeIease/src/vehicIe/libsrc/libvflags/clr_br_bitc) 

This  file  contains  a  routine  which  clears  bits  in  a  word  in  the  branch  values  array. 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubvflags.h" 

"vflagsjoc.h" 


2. 1.2. 2.4. 1.1  clr_br_bit 

This  routine  cle^  bits  specified  by  brjnask.  The  element  in  the  array  is  specified  by 
brjndex.  The  CIG  (CIG  1  or  CIG  2)  is  represented  by  cigjndex. 


Parameters 


Parameter 

br  index 
br  mask 
cig  index 


Type 

int 

WORD 

int 


Where  Typedef  Declared 
I  Standard 

mass  stdc.h _ 

I  Standard 


Table  2,1-306:  cir  br  bit  Information. 
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2.1.2.2.4.2  clr_vflags.c 

(ysimnet/release/src/vehicle/libsrc/libvflags/clr_vflags.c) 

This  file  contains  a  routine  which  clears  bits  in  a  word  in  the  view  Jlags  array. 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h'’ 

"sim_cig_if.h" 

"vflags_loc.h" 


2. 1.2. 2. 4. 2.1  clear_view__flags 

The  bits  specified  hyflag  jnask  in  a  word  in  the  view  Jlags  array  are  cleared.  The  CIG  is 
specified  by  index. 


1  Parameters  I 

Parameter 

Tvne 

Where  Typedef  Declared 

flaa  mask 

WORD 

mass  stdc.h 

index 

int 

Standard 

Table  2.1>307:  clear_view_flags  Information. 
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2. 1.2. 2. 4. 3  get_br_vals.c 

(./simnetAclease/src/vehicle/libsrc/libvflags/get_br_vals.c) 

This  file  contains  a  routine  which  returns  a  pointer  to  the  beginning  of  the  branch_yalues 
array. 

Includes; 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"vflagsjoc.h" 

2. 1.2. 2. 4. 3.1  get_br_vals 

A  pointer  to  the  beginning  of  the  branchjfalues  array  is  returned.  The  CIG  buffer  is 
sp^ified  by  index. 


Parameters 


Parameter 

index 


Return  Value 

branch_values[index] 


Type 

int 


Return  Values 


Type. 

WORD 


Where  Tvpedet  Declared 

Standard 


Meaning 

pointer  to  the  beginning  of  the 
I  branch  values  array _ 


Table  2.1-308:  get_br_vals  Information. 
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2. 1.2. 2. 4. 4  get_vflags.c 

(7siinnei^lease/src/vehicle/libsrc/libvflags/get_vflags.c) 

This  file  contains  a  routine  which  returns  the  value  of  a  particular  view  Jlags  word 


Includes: 


"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"vflags_loc.h" 


2. 1.2. 2. 4. 4.1  get_view_flags 

The  value  of  a  view  Jlags  word  is  returned  for  the  CIG  specified  by  index. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meanina 

view  flaasfindexl 

WORD 

value  of  a  view  flaasword 

Table  2.1-309: 


get_view_flags  Information. 
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2.1.2.2.4.5 


get_vinodes.c 

(7simnet/release/src/vehicle/libsic/libvflags/get_vmodes.c) 


This  file  contains  a  routine  which  returns  a  pointer  to  the  beginning  of  the  view  jnodes 
array. 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

''sim_cig_if.h" 

"vflags_loc.h" 


2. 1.2. 2. 4. 5.1  get_vmodes 

A  pointer  to  the  beginning  of  the  view  jnodes  array  is  returned  by  this  routine  for  the 
appropriate  CIG,  as  indicated  by  index. 


1  Parameters  I 

1  Parameter 

Tvoe 

Where  Tvpedef  Declared 

1  index 

int 

Standard 

Return  Values 

Return  Value 

Tvoe 

Meaning 

view_modes[index] 

pointer  to  WORD 

pointer  to  the  beginning  of  the 
view  modes  array 

Table  2.1-310:  get_vmodes  Information. 
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2. 1.2. 2. 4. 6  set_br__bit.c 

(./sitnnet^lease/src/vehicleAibsrc/libvflags/set_br_bitc) 

This  file  contains  a  routine  which  sets  bits  in  a  word  in  the  branch_yalues  array. 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"vflags_loc.h" 


2. 1.2. 2. 4. 6.1  set_br_bit 

Bits  specified  by  brjnask  in  a  word  in  the  branch_yalues  array  are  set  The  array  element 
is  specified  by  hr  index,  and  the  CIG  is  specified  by  cig  index. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

br  index 

int 

Standard 

br  mask 

WORD 

mass  stdc.h 

ciq  index 

int 

Standard 

Table  2.1>311:  set  br  bit  Information. 


2. 1.2. 2. 4. 7  set_br_vals.c 

(./sinuiet/release/src/vehicle/libsrc/libvflags/set_br_vals.c) 

This  file  contains  a  routine  which  sets  the  value  of  a  word  in  the  branch_yalues  array. 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

''dgi_stdg.h" 

"sim_cig_if.h" 

"vflagsjoc.h" 


2. 1.2. 2. 4. 7.1  set  br  vals 


This  routine  sets  the  value  of  a  word  in  the  branch  values  array  to  br  jnask.  The  element 
in  the  array  is  specified  by  br  index.  The  appropriate  CIG  is  represented  by  cig  jndex. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

br  index 

int 

Standard 

br  mask 

WORD 

mass  stdc.h 

ciQ  index 

int 

Standard 

Table  2.1-312:  set  br  vals  Information. 
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2. 1.2. 2. 4. 8  set_vflags.c 

(./siiimeVrelease/src/vehicle/libsrc/libvflags/set_vflags.c) 

This  file  contains  a  routine  which  sets  the  bits  in  a  word  in  the  view  Jlags  array. 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"vflagsjoc.h" 


2. 1.2. 2. 4. 8.1  set_view_flags 

The  bits  specified  by  flag  mask  in  a  word  in  the  view  Jlags  array  are  set.  The  CIG  is 
specified  by  index. 


1  Parameters  | 

Parameter 

Tvne 

Where  Typedef  Declared 

flaa  mask 

WORD 

mass  stdc.h 

index 

int 

Standard 

Table  2.1-313;  set_view_flags  Information. 


2. 1.2. 2. 4. 9  set_vmodes.c 

(./simnet/release/src/vehicle/libsicAibvflags/set_vmodes.c) 

The  routine  in  this  file  sets  the  value  of  a  word  in  the  viewjnodes  array. 

Includes: 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"vflagsjoc.h" 


2. 1.2. 2. 4. 9.1  set  vmodes 


The  value  of  a  word  in  the  view  modes  array  (ym  index)  is  set  to  vmjnask.  The 
appropriate  CIG  is  specified  by  cig  index. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

vm  index 

int 

Standard 

vm  mask 

WORD 

mass  stdc.h 

cia  index 

int 

Standard 

Table  2.1-314:  set  vmodes  Information. 
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2.1.2.2.4.10  vflags_loc.c 

(ysimnet^lease/sic/vehicle/libsrc/libvflags/vflagsjoc.c) 

The  view  Jlags,  view  modes,  and  branch_values  arrays  are  declared  in  this  file. 

Includes: 

"sini_types.h" 

"niass_stdc.h" 

"dgi_stdg.h" 

"sim_ci&_if.h" 

"vflags_loc.h" 


2.1.2.2.4.11  vision. c 

(./simnet/release/src/vehicle/libsrc/Iibvflags/vision.c) 

The  routines  in  this  file  are  not  used  by  the  Masscomp  or  Butterfly. 


2.1.2.2.4.12  vflags.loc.h 

(./simnet/release/src/vehicle/libsrc/libvflags/vflags_loc.h) 


BRVALS[MAX_BRANCH_VALUES] 

VMODES[16] 

view_flags[] 

branch_valuesn 

view_modes[] 


2.1.2.2.4.13  libvflags.h 

(7simnetA«lease/src/vehicle/libsrc/libvflags/libvflags.h) 

The  following  constants  are  defined: 

VIEWP_0 

VIEWP_1 

VIEWP_2 

VIEWP_3 

VIEWP_4 

VIEWP_5 

VIEWP_6 

VIEWP_7 

ALL.VIEWPORTS 


The  following  functions  are  declared: 
set_view_flags() 
clear  view_flags() 
get_v7ew_flags() 
setT)r_vais() 
get_br~vals() 
set~vmodes() 
gervmodesO 
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2.1.2.2.5 


libio^simul 

(./si5inet/release/src/libsrc/libio_simul  [libio.  ul]) 


libio.simul  is  instrumental  in  the  sending  and  receiving  of  data  message  buffers.  This 
library  controls  the  input  to  and  output  from  the  CIG. 


2.1.2.2.5.1  io_^simul.c 

(ysimnely^lease/sr:;/libsrc/libio_simuVio_simul.c) 


Includes: 

"stdio.h" 

"sim_dfns.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"rtc.h" 

"bbd.h’' 

"libcig.h" 

"Ubrva.h" 

"libnetwork.h" 

"status.h" 

"gbuffer.h" 

"Ubcig.h" 

Declaradons: 

last_time 

using_ethemet 
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2. 1.2. 2. 5. 1.1  io_simul 

This  routine  controls  the  input  to  and  output  from  the  CIG  during  the  simulation  state.  The 
routine  first  waits  to  receive  a  buffer  from  the  CIG.  To  increase  productivity  while 
waiting,  the  routine  processes  packets  from  the  network.  After  successfully  receiving  a 
buffer,  the  routine  sends  a  message  buffer  to  the  CIG.  The  routine  check  buffer()  is 
called  to  check  that  the  sent  buffer  contained  valid  messages.  The  routine  also  checks 
buffers  sent  to  a  second  CIG  (if  present).  The  buffer  received  from  the  CIG  is  processed 
by  calling  cig_process_buffer().  Note  that  the  CIG  determines  the  start  of  a  frame  by 
sending  anoAer  buffer  To  the  host  io_simulO  waits  for  the  start  of  the  next  frame  by 
processing  network  packets  and  polling  the  CIG  until  the  next  buffer  is  received. 


1  Internal  Variables 

Variable 

Where  Typedef  Declared 

fail  time 

reaister  long 

Standard 

Calls 


Function 

Where  Described 

net  current  time 

See  MCC  CSCI SDD  Section  2.20.2.8.3 

network  get  net  handle 

Section  2.1.1.3.2.12.1 

rtc  start  time 

Section  2.6.16.1.2 

cig  receive  buffer 

Section  2.1. 2.2.1. 9.1 

cig  failed  fsm 

Sections  2.1. 5.2,  2.1 .5.3,  and  2.1. 5.4 

process  a  packet 

Section  2.1.1.3.2.18.8 

cig  send  buffer 

Section  2.1.2.2.1.10.1 

check_  buffer 

Section  2.1.2.2.2.18.1 

get  front  of  send  buffer 

Section  2.1.2.2.2.32.1 

get  cig2  present 

Section  2.1.2.2.1.17 

bbd  bit  out 

Section  2.1 .5.1. 4.1 

cig  process  buffer 

Section  2.1. 2.2.1. 7.1 

rtc  stop  time 

Section  2.6.16.1.3 

Table  2.1-315:  io  simul  Information. 
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2. 1.2. 2. 5. 1.2  io_simul_idle 

During  idle  state,  it  is  still  necessary  for  the  simulation  to  communicate  with  the  CIG. 

This  routine  controls  the  input  to  and  output  from  the  CIG  during  the  idle  state.  As  when 
the  simulation  is  running,  the  routine  waits  to  receive  a  buffer  from  the  CIG.  By  calling  the 
routine  network_xmit_idle(),  the  routine  is  allowed  to  process  packets  from  the  network 
during  the  idle  state.  C5hce  the  CIG  buffer  is  successfully  received,  the  routine  prepares 
and  sends  a  null  buffer  to  the  CIG.  As  with  the  routine  io_simul(),  this  routine  waits  to 
receive  the  next  buffer  from  the  CIG  by  polling  the  CIG  and  processing  network  packets. 
Note  that  during  the  idle  state,  the  frame  interruption  wiU  not  necessarily  come  at  regular 
1/15  second  intervals.  The  routine  buffer_reset()  is  called  in  order  to  clear  out  the  CIG 
buffer  and  reset  the  pointers. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

done 

int 

Standard 

fail  time 

register  long 

Standard 

now 

Standard 

1  Calls  1 

Function 

Where  Described 

cig  receive  buffer 

Section  2.1 .2.2. 1.9.1 

net  current  time 

See  MCC  CSCI  SDD  Section  2.20.2.8.3 

network  get  net  handle 

Section  2.1.1.3.2.12.1 

cig  failed  fsm 

Sections  2. 1.5.2,  2. 1.5.3,  and  2. 1.5.4 

Section  2. 1.2.2. 1.4.1 

cig  send  buffer 

Section  2.1.2.2.1.10.1 

network  xmit  idle 

Section  2.1.1.3.1.32.3 

process  a  packet 

Section  2.1.1.3.2.18.8 

buffer  reset 

Section  2.1.2.2.2.15.1 

Table  2.1>316:  io  simul  idle  Information. 
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2. 1.2. 2. 6  ml_cig.c 

(./surinet/release/src/vehicle/m  1/src/m  l_cig.c  [ml  _cig.c]) 

The  file  ml_cig.c  contains  information  regarding  the  CIG  that  is  specific  to  the  Ml 
simulator.  It  consists  mainly  of  information  about  the  specific  vehicle's  orientation  and 
position,  initialization  messages  specific  to  the  vehicle,  and  the  routine  to  actually  format 
the  buffer  to  be  sent  to  the  CIG. 

Includes: 

"stdio.h" 

"signal.h" 

"math.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 

"pro_sim.h" 

"mun_type.h" 

"libkin.h" 

"librva.h" 

"libimps.h" 

"libhulLh" 

"libnetwork.h" 

"libtunet.h" 

"gcom.h" 

"gbuffer.h" 

"libvflags.h" 

"ml_turret.h" 

"ml_vision.h" 

Declarations: 

t_to_h_in_h[3] 

c_to_t_in_t[3] 

l_to_t_in_t[3] 

^to_t-in_t[3] 

init_Iaser_ctr 

ball_debug 

cws_cos 

cws_sin 

lpscope_cos 

lpscope_sin 

tmp_mtx 
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Definitions: 

GNR_3x 

GNR_10x 

GNR_MAG_BR_VAL 

H_TO_W_NODE 

T_TO_H_NODE 

G_TO_T_NODE 

LDR_PSCX)PE 

CMDR_CUPOLA 


2. 1.2. 2. 6.1  set_ballistics_debug 
This  routine  sets  ball  debug  to  state. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

state 

int 

standard 

Table  2.1-317:  set_ballistics_debug  Information. 

2. 1.2. 2. 6. 2  get_baliistics_debug 

This  routine  retims  ball_debug,  indicating  if  debugging  is  on  or  off. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

balLdebug 

int 

TRUE  -  debugging  is  enabled 
FALSE  -  debugging  is 
disabled 

Table  2.1-318;  get_ballistics_debug  Information. 


2. 1.2. 2. 6. 3  cig_init_ctr 

This  routine  initializes  a  counter.  It  sets  init  laser  ctr  to  0. 


2. 1.2. 2. 6. 4  cig_gps_mag_10x 

This  routine  sets  the  magnification  of  the  gunner’s  sight  to  lOx. 


1  Calls  1 

Function 

Where  Described 

set  br  vals 

Section  2. 1.2.2. 4.7.1 

Table  2.1-319:  cig_gps_mag_10x  Information. 
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2. 1.2. 2. 6. 4  cig_gps_mag_3x 


This  routine  sets  the  magnification  of  the  gunner’s  sight  to  3x. 


1  Calls  1 

Function 

Where  Described 

■  set  br  vals 

Section  2.1.2.2.4.7.1 

Table  2.1-320:  cig_gps_inag_3x  Information. 


2 . 1 . 2 . 2 . 6 . 5  cig_msg_prepend_my_veh_state 

This  routine  prepends  to  the  front  of  the  CIG  message  buffer  information  necessary  to 
correctly  portray  the  host  vehicle's  orientation  and  position.  The  message  which  is  sent  to 
the  graphics  box  to  inform  it  of  what  to  display  is  usually  partially  constructed.  The 
information  concerning  the  remote  vehicles  which  are  visible  is  laid  out  in  the  middle  of  the 
buffer,  additional  information  is  prepended  above  this  part  of  the  buffer.  Most  of  the 
information  in  the  buffer  is  relat^  to  the  remote  vehicles.  Only  information  necessary  to 
indicate  a  change  in  the  host  vehicle's  position,  orientation,  an^or  appearance  is  updated  as 
required;  therefore,  less  information  is  added  to  the  buffer  at  each  tick. 


I  Internal  Variables  | 

Internal  Variable 

Where  Tvoedef  Declared 

mat  temp 

T  MATRIX 

Sim  tvpes.h 

vec  tmp 

VECTOR 

Sim  tvpes.h 

Calls 

Function 

Where  Described 

multi_cigj3repend_rts4x3_ 

matrix 

Section  2.1.2.2.2.82.1 

kinematics  pet  w  to  h 

Section  2.5.8.2.1 

kinematics  qet  h  to  o 

Section  2.5.8.2.3 

vec  mat  mul 

Section  2.6.2.56.1 

mat  trip  init 

Section  2.6.2.34.1 

multi  cip  prepend  viewflaps 

Section  2.1.2.2.2.89.1 

pet  view  flaps 

Section  2.1.2.2.4.3.1 

pet  br  vals 

Section  2.1.2.2.4.4.1 

pet  cip2  present 

Section  2.1.2.2.1.17 

multi_cig_msg_prepend_ 
request  laser  range 

Section  2.1.2.2.2.81.1 

Table  2.1-321:  cig_msg_prepend_my_veh_slate  Information. 


2. 1.2. 2. 6. 6  cig_prepare_buffer 

This  routine  prepares  the  CIG  buffer.  The  routine  impacts_tell_cig_about_impacts() 
is  called  to  obtain  special  effects  information  for  impacts.  The  routine 
rva_tell^cIg_about_other_vehicles()  is  called  to  determine  which  vehicles  are  visible. 
Informa^n  is  added  to  the  buffer  for  new  moving  visible  vehicles  and  is  deleted  from  the 
buffer  for  former  moving  visible  vehicles.  This  routine  then  calls 
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cig  adjust_for_changed_staticveh()  to  handle  static  vehicles  that  have  changed 
vehicle  type^  The  routine*cig_insg_prepend_staticveh_state()  is  called  to  inform  the 
CIG  of  new  static  vehicles  that  are  to  be  <isplayed.  The  routine 
cig  msg__prepend_staticveh_rem()  is  called  to  inform  the  CIG  of  static  vehicles  that 
no  IbngeF need  to  be  displayed. 


Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

num  static 

int 

standard 

num  rm 

int 

standard 

num_  cha 

int 

standard 

chgvehs 

pointer  to  pointer  to 

RVA  ENTRY 

librva.h 

staticvehs 

pointer  to  pointer  to 

RVA  ENTRY 

libn/a.h 

rmvehs 

pointer  to  pointer  to 

RVA  ENTRY 

librva.h 

sbp 

pointer  to  S  BUFFER 

libmsa.h 

Calls  1 

Function 

Where  Described 

cig_not_ok_to_prepare_ 

buffer 

Section  2.1.2.2.1.23.1 

copy  ballistics  buffer 

Section  2.1.2.2.2.14.1 

cig  msg  prepend  my  veh 
state 

Section  2.1. 2.2.8  3 

copy  Z  rot  to  TF2 

Section  2.6.4.9.1 

cig_msg_prepend_gun_ 

overtav 

Section  2.1.2.2.2.71.1 

firecti  ready  to  fire 

Section  2.2.2.2.3 

firecti  malfunction 

Section  2.2.2.2.3 

laser  multiple  returns 

Section  2. 2.3.2 

bcs  oet  range  str 

Section  2.2.3. 1 

turret  qet  azimuth  str 

Section  2.5.5.2.19 

impacts_tell_cig_about_ 

impacts 

Section  2.5.15.1.2 

rva_telLcig_about_other_ 

vehicles 

Section  2.5.12.27.1 

rva  oet  lists 

Section  2.5.12.9.2 

cig_adjustJor_changed_ 

staticveh 

Section  2.1.2.2.2.2.3 

cig_msgj3repend_staticveh_ 

state 

Section  2.1.2.2.2.98.1 

cig_msgjDrepend_staticveh_ 

rem 

Section  2.1.2.2.2.97.1 

Table  2.1-322:  cig_prepare_buffer  Information. 
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2. 1.2. 2. 6. 7  cig_spec_init 


This  routine  is  called  by  hbcig  to  initialize  CIG-ielated  information  that  is  specific  to  a 
particular  simulation.  In  the  case  of  the  Ml,  it  requests  that  laser  range  values  be  returned 
every  frame. 


1  Calls  1 

Function 

Where  Described 

multLcig jsrepe  nd_request_ 
laser  range 

Section  2.1.2.2.2.81.1 

Table  2.1>323:  cig_spec_init  Information. 


2. 1.2. 2. 6. 8  ci  g_setu  p_confi  gu  ration 

This  routine  sets  up  the  configuration  file  by  calling  the  routine 
cig_set_view_config_fiIe().  The  configuration  message  is  prepared  via 
cig”me'ssage”configure_view(),  and  is  sent  to  the  CIG  via  cig_send_buffer(). 
Upon  receipt  of  the  configuration  message,  the  CIG  sends  back  an  acknowledgement  via 
cig_receive_buffer(). 
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2.1.2.2.7  m2_^cig.c 

(7slninet/release/src/vehicle/m2/src/m2_cig.c  [m2_cig.c]) 

The  file  m2_cig.c  contains  information  regarding  the  CIG  that  is  specific  to  the  M2 
simulator.  It  consists  mainly  of  information  about  the  specific  vehicle's  orientation  and 
position,  initialization  messages  specific  to  the  vehicle,  and  the  routine  to  actually  format 
the  buffer  to  be  sent  to  the  CIG. 

Includes; 

"stdio.h" 

"signal.h" 

"math.h" 

”sim_dfns.h" 

"sim_macros.h" 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libmsg.h" 

"pro_sim.h" 

"mun_type.h" 

"libkin.h" 

"Ubrva.h" 

"Ubimps.h" 

"libhulLh" 

"libturret.h" 

"libnetwork.h" 

"libmissile.h" 

"libvflags.h" 

"gcom.h" 

"m2_ammo.h" 

Declarations: 

gps_hi_mag 

mydebug 

ball_debug 

t_to_h_in_h[3] 

c_to_t_in_t[3] 

g_to_t_in_t[3] 

brow_pad_first_time 

tmp_m 

cig_dead() 

Definitions: 

H_TO_W_NODE 

T_TO_H_NODE 

G_TO_T_NODE 

GC_TO_T_NODE 

C_TO_T_NODE 

CR_TO_T_NODE 
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2. 1.2. 2. 7.1  set_ballistics_debug 
This  routine  sets  balljiebug  equal  to  state. 


2. 1.2. 2. 7. 2  get_ballistics_debug 

This  routine  returns  the  status  of  ball  jiebug,  indicating  whether  or  not  debugging  is 
enabled  or  disabled 


Return  Values 


Return  Value 


balLdebug 


Meaning _ 


status  of  ballistics  debugging 


Table  2.1-325:  get_ballistics_debug  Information. 


2. 1.2. 2. 7. 3  init_brow_pad_state 

brow  j>adjirst  time  is  initialized  to  1. 
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2 . 1 . 2 . 2 . 7 . 4  cig_msg_prepend_my_veh_sta  te 

This  routine  prepends  to  the  front  of  the  CIG  message  buffer  information  necessa^  to 
correctly  portray  the  host  vehicle's  orientation  and  position.  The  message  which  is  sent  to 
the  graphics  box  to  inform  it  of  what  to  display  is  usually  partially  constructed.  The 
information  concerning  the  remote  vehicles  which  are  visible  is  laid  out  in  the  middle  of  the 
buffer,  additional  information  is  prepended  above  this  part  of  the  buffer.  Most  of  the 
information  in  the  buffer  is  related  to  the  remote  vehicles.  Only  information  necessary  to 
indicate  a  change  in  the  host  vehicle’s  position,  orientation  and/or  appearance  is  updated  as 
required;  therefore,  less  information  is  added  to  the  buffer  at  each  tick. 


1  Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

mat  temp 

T  MATRIX 

Sim  tvpes.h 

vec  tmp 

VECTOR 

Sim  tvpes.h 

cws  sin 

REAL 

Sim  tvpes.h 

cws  cos 

REAL 

Sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

cig  msg  prepe  nd_rts4x3_ 
matrix 

Section  2.1.2.2.2.94.1 

kinematics  aet  w  to  h 

Section  2.5.8.2.1 

kinematics  aet  h  to  o 

Section  2.5.8.2.3 

vec  mat  mul 

Section  2.6.2.56.1 

cupola_get_reaLcws_sin_ 
and  cos 

Section  2.3  6.1. 2.2 

mat  trio  init 

Section  2.6.2.34.1 

cio  mso  prepend  viewflags 

Section  2.1.2.2.2.106.1 

get  view  flags 

Section  2.1.2.2.4.4.1 

get  br  vals 

Section  2.1.2.2.4.3.1 

get  brow  pad  status 

Section  2.3.6.3.2.27 

cig_msgj3repend_view_ 

mode 

Section  2.1.2.2.2.108.1 

get  vmodes 

Section  2.1.2.2.4.5.1 

Table  2.1*326:  cig_insg_prepend_iny_veh_state  Information. 


2. 1.2. 2. 7. 5  cig_prepare_buffer 

This  routine  prepares  the  CIG  message  buffer.  The  routine 

impacts_tell_cig_^about_impacts()  is  called  to  obtain  special  effects  information  for 
impacts.'The~rou5ne  rva_ten_cig_about_other_vehicIes()  is  called  to  determine 
which  vehicles  are  visible.  Information  is  added  to  the  buffer  for  new  moving  visible 
vehicles  and  is  deleted  from  the  buffer  for  former  moving  visible  vehicles.  This  routine 
then  calls  cig_adjust_for_changed_staticveh()  to  handle  static  vehicles  that  have 
changed.  The  routine  cig”msg_prepend_staticveh_state()  is  called  to  inform  the  CIG 
of  new  static  vehicles  that  arc  to  be  displayed.  The  routine 

cig  msg_prepend_staticveh_rem()  is  called  to  inform  the  CIG  of  static  vehicles  that 
no  longer  need  to  be  displayed. 
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1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Tvpedef  Declared 

num  static 

int 

standard 

num  rm 

int 

standard 

num  cha 

int 

standard 

chgvehs 

pointer  to  pointer  to 

RVA  ENTRY 

librva.h 

staticvehs 

pointer  to  pointer  to 

RVA  ENTRY 

librva.h 

rmvehs 

pointer  to  pointer  to 

RVA  ENTRY 

librva.h 

Calls 

Function 

Where  Described 

cig_not_ok_to_prepare_ 

buffer 

Section  2.1.2.2.1.23.1 

CODV  ballistics  buffer 

Section  2.1.2.2.2.14.2 

cig_msg_prepend_my_;veh_ 

state 

Section  2.1.2.2.7.4 

cupola_get_cws_CQS_and_ 

sin 

Section  2.3.6.1.2.1 

cig_msg .prepend  gun 
overlay 

Section  2.1.2.2.2.75.1 

turret  get  azimuth  str 

Section  2.5.5.2.19 

bcs  get  range  str 

Section  2.3.3.1.12 

map_get_ammo_entry_from_ 
network  type 

Section  2.6.11.2.1 

ammo  round  indexed  status 

Section  2.3.5.1.28 

impacts_tell_cig_about_ 

impacts 

Section  2.5.15.1.2 

rva_tell_cig_about_other_ 

vehicles 

Section  2.5.12.27.1 

rva  get  lists 

Section  2.5.12.9.2 

cig_adjust_for_changecfl_ 

staticveh 

Section  2.1.2.2.2.2.3 

cig_msgj3repend_statRcveh_ 

state 

Section  2.1.2.2.2.98.1 

cig_msgj3repend_stat»icveh_ 

rem 

Section  2.1.2.2.2.97.1 

Tabl«  2.1-327:  cig-prepare_buffer  Information. 
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2. 1.2. 2. 7. 6  cig_spec_init 


This  routine  is  called  by  libcig  to  initialize  CIG-related  inforaiation  that  is  specific  to  a 
particular  simulator.  In  the  case  of  the  M2,  it  prepends  the  ammo_define  message. 


Calls 

Function 

Where  Described 

cig  msg  prepend  ammo 
define 

Section  2.1.2.2.2.67.1 

map_get_ammo_entryJrom_ 
network  type 

Section  2.6.11.2.1 

Table  2.1-328:  cig_spec_init  Information. 
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2.1.2.2.8  kato^cig.c 

(./sramet/release/src/vehicle/kato/src/kato_cig.c  [kato_cig.c] ) 

The  die  kato_cig.c  contains  information  regarding  the  CIG  that  is  specific  to  the  Stealth 
vehicle  simulation.  It  consists  mainly  of  information  about  the  specific  vehicle's  orientation 
and  position,  initialization  messages  specific  to  the  vehicle,  and  the  routine  to  actually 
format  the  buffer  to  be  sent  to  the  CIG. 

Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"mass_stdc.h" 

"dgi_stdg.h’' 

"sim_cig_if.h" 

"libmsg.h" 

"pro_sim.h" 

"mun_type.h" 

"libkin.h" 

"librva.h" 

"libimps.h" 

"UbhulLh" 

"libnetwork.h" 

"libturret.h" 

"librotate.h" 

"libair.h" 

"gbuffer.h" 

"libvflags.h" 

Declarations: 

ident_mat 

init_cig_ticks 

Definition: 

CIG_INIT_WAIT 


2. 1.2. 2. 8.1  cig_init_ctr 

This  routine  initializes  a  counter.  It  sets  init  cig  ticks  to  0. 


2. 1.2. 2. 8. 2  cig_local_init 

This  routine  is  a  stub. 
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2. 1.2. 2. 8. 3 


cig_msg_prepend_my_veh_state 


This  routine  prepends  to  the  front  of  the  CIG  message  buffer  information  necessary  to 
correctly  portray  the  host  vehicle's  orientation  and  position.  The  inessage  which  is  sent  to 
the  graphics  box  to  inform  the  CIG  of  what  to  display  is  usually  partially  constructed.  The 
information  concerning  the  remote  vehicles  which  are  visible  is  laid  out  in  the  middle  of  the 
buffer,  additional  information  is  prepended  above  this  part  of  the  buffer.  Most  of  the 
information  in  the  buffer  is  related  to  the  remote  vehicles.  Only  information  necessary  to 
indicate  a  change  in  the  host  vehicle's  position,  orientation,  and/or  appearance  is  updated  as 
required;  therefore,  less  information  is  added  to  the  buffer  at  each  tick. 


1  Calls  1 

Function 

Where  Described 

rotate  send  msas 

Section  2.5.18.3.1 

ciQ  msQ  oreoend  viewflaqs 

Section  2.1.2.2.2.106.1 

get  view  flags 

Section  2.1.2.2.4.3.1 

get  br  vals 

Section  2.1.2.2.4.4.1 

Table  2.1-329:  cig_msg_prepend_my_veh_state  Information. 
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2. 1.2. 2. 8. 4  cig_prepare_buffer 

This  routine  prepares  the  CIG  buffer.  The  routine  impacts_teU  cig_abouMmpacts() 

is  called  to  obtain  special  effects  information  for  impacts.  The'routme  ~ 

rva_tell  cig_about_other_vehiclesO  is  called  to  determine  which  vehicles  are  visible 

Informa^n  is  added  to  the  buffer  for  new  moving  visible  vehicles  and  is  deleted  fiom  the 

buffer  for  former  moving  visible  vehicles.  This  routine  then  calls 

cig_^adjust_for  changed_staticveh()  to  handle  static  vehicles  that  have  changed 

vehicle  type^.  TEe  routine'cig_iiisg_prepend_staticveh_state()  is  called  to  inform  the 

CIG  of  new  static  vehicles  that  are  to  be  displayed.  The  routine 

cig  msg_prepend_staticveh_rem()  is  called  to  inform  the  CIG  of  static  vehicles  that 

no  longer need  to  be  displayed. 


Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

num  static 

int 

standard 

num  rm 

int 

standard 

num  cha 

int 

standard 

chgvehs 

pointer  to  pointer  to 

RVA  ENTRY 

librva.h 

staticvehs 

pointer  to  pointer  to 

RVA  ENTRY 

librva.h 

rmvehs 

pointer  to  pointer  to 

RVA  ENTRY 

librva.h 

Calls 

Function 

Where  Described 

cig_not_ok_to_prepare_ 

buffer 

Section  2.1.2.2.1.23.1 

copy  ballistics  buffer 

Section  2.1.2.2.2.14.1 

cig_msgj3repend_my_veh_ 

state 

Section  2.1.2.2.8  3 

impacts_tell_cig_about_ 

impacts 

Section  2.5.15.1.2 

rva_telLcig_about_other_ 

vehicles 

Section  2.5.12.27.1 

rva  qet  lists 

Section  2.5.12.9.2 

cig_adjust_for_changed_ 

staticveh 

Section  2.1.2.2.2.2.3 

cig_msg J3repend_st  at  icve  h_ 
state 

Section  2.1.2.2.2.98.1 

cig_msgj3repend_staticveh_ 

rem 

Section  2.1.2.2.2.97.1 

Table  2.1-330:  cig_prepare_buffer  Information. 
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2. 1.2. 2. 8. 5  cig_spec_init 

This  routine  is  called  by  libcig  to  initialize  CIG-ielated  information  that  is  specific  to  a 
particular  simulation.  In  the  case  of  the  Stealth,  it  requests  that  an  AGL  value  be  returned 
every  frame. 


1  Calls  1 

■  Function  1 

Where  Described 

Section  2.1.2.2.2.66.1 

Table  2.1-331:  cig_spec_init  Information. 
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2.1.2.2.9  kato_view.c 

(7sunnet^lease/src/vehicle/kato/srcAcato_view.c  [kato_view.c]) 

Kato_view.c  allows  the  Stealth  to  view  the  battlefield. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_<feis.h” 

"sim_macros.h"’ 

"libmsg.h" 

"Ubmath.h" 

”kato_cntrLh" 

"kato.view.h" 


Defines: 

View  Constant  Value 

VIEW_CENTEE£ED  0.0 

VIEW_MAX_SLEW  0.067 

VIEW_PITCH_Sa£W_PARAM  0.00009 

VIEW_IND_DEL,TA  0.1745 

VIEW_IND_NUM_SEG_ABOVE  4 

VIEW_IND_NUlM_SEG_BELOW  5 

VIEW_MAG_NCaDE  4 

VIEW_PITai_lS50DE  3 

VIEW_YAW_NDDE  2 

VIEW_SLEWJEH>  0 

VIEW.SLEW  DOWN  1 

VIEW_SLEW_HOLD_PITCH  2 

VIEW_SLEWjaENTER_PITCH  3 

VIEW_SLEW_SET_PITCH  4 

VIEW_SLEW_HIOLD_YAW  5 

VIEW_SLEW_CENTER_YAW  6 

NLOS.VIEWJOFFSET  0.1 

VIEW_NLOS_MAX_PITCH_ANGLE  0.7071 
VIEW_NLOS_MAX_YAW_ANGLE  0.34906585 


REAL  variable  declaraticKis  and  initialization: 
old_view_pitcli_pos 
view_pitch_base 
view_pitch_set_auigle  =  0.0 
old_view_yaw_pos 
view_yaw_base 
view_cpo_elev^_rate  =  0.0 
view_func_argst9] 


int  variable  declarations:: 

view_pitch_slew_state 
view_pitch_sle  w  _count 
view_yaw_slew_state 
view_yaw_slew  _count 
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REAL  procedure  declarations: 
yaw_filterO 
pitch_filte^) 

Macros  invoked: 

ROTATE_ELEMENT_DEF(view_pitch_elenient) 

ROTATE_ELEMENT_DEF(view_yaw_element) 

ROTATE_ELEMENT_DEF(view_mag_element) 


2. 1.2. 2. 9.1  view 

This  routine  returns  the  pointer  &view_pitch_element 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

&view_pitch_element 

pointer  to 

ROTATE  ELEMENT 

Normal  end 

Table  2.1>332:  view  Information. 


2. 1.2. 2. 9. 2  view_init 

This  routine  is  the  view  initialization  routine. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

view  pitch  bottom 

REAL 

sim  types.h 

Errors 

Error  Name 

Reason  for  Error 

view  init:  bad  cubic 

A  call  to  find  cubic  func  was  unsuccessful. 

Calls 

Function 

Where  Described 

rotate  init  element 

Section  2.5.18.4.2 

hull 

Section  2.5.18.3.6 

rotate  init  cio  element 

Section  2.5.18.3.1 

controls  view  ind  init 

Section  2.2.2 

controls  view  ind  centered 

Section  2.2.2 

find  cubic  func 

Section  2.6.1. 2.1 

Table  2.1>333:  view  init  Information. 
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2. 1.2. 2. 9. 3  view_simul 

This  routine  is  the  view  simulation  routine. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

temp 

REAL 

Sim  tvpes.h 

view  Ditch  pos 

REAL 

Sim  types.h 

new  sea 

int 

Standard 

old  sea 

int 

Standard 

new  vaw  anale 

REAL 

Sim  types.h 

new  pitch  anale 

REAL 

Sim  types.h 

Calls 

Function 

Where  Described 

rotate  set  anale 

Section  2.5.18.4.17 

rotate  aet  anale 

Section  2.5.18.4.31 

controls  view  ind  up 

Section  2.2.2 

controls  view  ind  down 

Section  2.2.2 

rotate  set  rate 

Section  2.5.18.4.18 

rotate  set  anale 

Section  2.5.18.4.17 

Table  2.1>334:  view  simul  Information. 


2 . 1 . 2 . 2 . 9 . 4  view_set_cpo_elevate_rate 

This  routine  sets  view_cpo_elevate_rate  equal  to  newjrate. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

new  rate 

REAL 

Sim  types.h 

Table  2.1-335:  view_set_cpo_elevate_rate  Information. 


2. 1.2. 2. 9. 5  view_set_pitch_rate 
This  routine  sets  the  pitch  rate. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

new  rate 

REAL 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

rotate  set  rate 

Section  2.5.18.4.18 

Table  2.1-336:  view_set_pitch_rate  Information. 
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2. 1.2. 2. 9. 6  view_centered 
This  routine  centers  the  view. 


1  Calls  1 

Function 

Where  Described 

rotate  set  max  rate 

Section  2.5.18.4.10 

Table  2.1-337:  view  centered  Information. 


2. 1.2. 2. 9. 7  view_up_depressed 


1  Calls  1 

Function 

Where  Described 

rotate_set  max  rate 

Section  2.5.18.4.10 

Table  2.1-338:  view_up_depressed  Information. 


2. 1.2. 2. 9. 8  view_up_released 

This  routine  sets  view_pitch_slew_state  equal  to  the  defined  constant 
VIEW_SLEW_HOLD_PITCH. 


2. 1.2. 2. 9. 9  view_down_depressed 


1  Calls  1 

Function 

Where  Described 

rotate,  set  max  rate 

Section  2.5.18.4.10 

Table  2.1-339:  view_down_depressed  Information. 


2.1.2.2.9.10  view_down_released 

This  routine  sets  view_pitch_slew_state  equal  to  the  defined  constant 
VIEW_SLEW_HOLD_PITCH. 
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view_to_world 

Before  diEB  routine,  the  two  variables  VIEW_C_WORLD  and  VIEW_C_BODY  are 
declared  ss  type  T_MATRIX. 


1  Return  Values  1 

Return  MKalue 

Meanlna 

rotate  aet  <mat(...) 

T  MAT  PTR 

Normal  end 

1  Calls  1 

Function) 

Where  Described 

rotate  aet  mat 

Section  2.5.18.5.5 

world 

Section  2.5.18.6.8 

Table  2.1-340:  view  to  world  Information. 


2.1.2.2.9.12  view_get_desi red_missile_heading 

This  routiirte  has  been  commented  out.  It  declares  one  internal  variable. 


1  Internal  Variables  1 

Internal  Wariable 

Where  Tvoedef  Declared 

new  ana 

REAL 

Sim  tvoes.h 

Tal>le  2.1-341: 


view_get_desired_missile_heading  Information. 


2.1.2»2..‘9.13  view_get_pitch_angle 


This  rout^  returns  the  pitch  angle. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

pitch  angle 

REAL 

Sim  tvoes.h 

1  Return  Values  1 

Return  V^lue 

Meaning 

pitch  angle 

REAL 

Normal  end 

1  Calls  1 

Function 

Where  Described 

rotate  get  angle 

Section  2.5.18.4.31 

Table  2.1-342:  view_get_pitch_angle  Information. 
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2.1.2.2.9.14  view_get_yaw_angle 
This  routine  returns  the  yaw  angle. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

vaw  anale 

REAL 

Sim  tvpes.h 

Return  Values 

Return  Value 

Type 

Meaning 

vaw  anale 

REAL 

Normal  end 

Calls 

Function 

Where  Described 

rotate  aet  angle 

Section  2.5.18.4.31 

Table  2.1-343:  view_get_yaw_angle  Information. 


2.1.2.2.9.15  yaw_filter 

Constants  for  use  in  the  following  routines  are  defined  prior  to  this  routine  as  follows: 


Constant 

A 

B 

C 

D 

E 

F 


Value 

100.0 

200.0 

100.0 

1500.0 

-1800.0 

300.0 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

angle 

REAL 

Sim  types. h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

theta  dlSI 

double 

Standard 

thetafSI 

double 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

thetafOl 

REAL 

angle 

Table  2.1-344:  yaw_nUer  Information. 


I 
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2.1.2.2.9.16  pitchjilter 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

REAL 

Sim  types.h 

1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

theta  dr31 

double 

Standard 

thetaf31 

double 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

thetafOl 

REAL 

anole 

Table  2.1-345:  pitch_filter  Information. 


2.1.2.2.9.17  view_set_pitch_angle 
This  routine  sets  the  pitch  angle. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Ditch 

REAL 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

rotate  set  max  rate 

Section  2.5.18.4.10 

Table  2.1-346:  view_set_pitch_angle  Information. 
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2. 1.3.1  libsound.c 

(./sininet/release/src/libsrc/libsound.c  [libsound.c] ) 

Includes: 

"stdio.h" 

"math.h" 

"sim_dfns.h" 

’'sim_inacros.h" 

"sim_types.h" 

"basic.h" 

"obj_type.h" 

"timers_dfn.h" 

"timers.h" 

"libsoundh" 

"libsound_dfn.h" 

"libmap.h" 

"libniap_dfn.h" 

External  procedure  declarations: 

sound_inake_veh_spec_sound() 

sound_force_veh“spec_sound() 


Defines: 

RANGE_SQ_CLOSE 

RANGE_SQ_MED 

RANGE_SQ_FAR 

MAX_VAR_SOUND 
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2 . 1 .3 . 1 . 1  sound_of_weapons_impact 

The  vehicle  specific  code  contains  an  array  of  sounds  to  be  made.  This  array  classifies  the 
different  types  of  sounds  in  a  consistent  order  for  all  types  of  vehicles  based  on  the  type  of 
ammo,  the  type  of  impact,  and  the  distance  fiom  the  vehicle  to  the  impact.  This  routine 
uses  die  parameters  of  a  specific  impact  to  calculate  the  index  into  the  sound  airay  which 
will  determine  which  sound  is  to  be  made. 

The  input  parameters  are: 

ammojndex  -  the  index  into  the  ammo  mapping  array  (describes  the  type  of  ammo) 
impactjype  —  the  type  of  impact  (muzzle  Hash,  impact,  no  impact,  etc.) 
range_sq  -  the  distance  from  the  vehicle  to  the  impact,  for  determining  sound  delays 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

ammo  index 

int 

Standard 

uiii 

int 

Standard 

1  range  so 

REAL 

Standard 

1  Internal  Variables  1 

Variable 

Tvoe 

Where  Typedef  Declared 

sound  index 

int 

Standard 

ammo  tvoe 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

mao  oet  ammo  class  from  ammo  entry 

Section  2.6.11.2.13 

innn'j--g.M'h'\g!gg— — — 

Section  2.6.3.4.1 

frame  delay  of  sound 

sound  make  const  sound 

Section  2.1. 3. 1.2 

Table  2.1<347:  sound_of_weapons_impact  Information. 
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2. 1.3. 1.2  sound_make_const_sound 

This  routine  determines  which  constant  sounds  Pt  to  be  made,  and  calls  the  vehicle 
specific  code  to  interface  with  the  sound  system.  The  parameter  sound  index  is  an  index 
into  the  sound  array  in  the  vehicle  specific  code.  Note  that  the  vehicle  specific  code  actually 
makes  the  sound  with  the  string  passed  by  this  routine. 


1  Parameters  1 

1  Parameter 

Type 

Where  Tvpedef  Declared 

1  sound  index 

int 

Standard 

1  1 

Internal 

Variables 

Variable 

Type 

Where  Tvpedef  Declared 

length 

int 

Standard 

Calls 

Function 

Where  Described 

sound  make  veh  soec  sound 

Sections  2.1. 3.2.2.  2.1. 3.3.2.  and  2.1. 3.4.2 

Table  2.1*348:  sound  make  const  sound  Information. 


2. 1.3. 1.3  sound_force_const_sound 

This  routine  forces  a  constant  sound  specified  in  the  parameter  soundjndex,  regardless  of 
whether  the  vehicle  specific  code  disallows  the  sound. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

sound  index 

int 

Standard 

1  1 

Internal 

Variables 

Variable 

Type 

Where  Tvpedef  Declared 

length 

int 

Standard 

Calls 

Function 

Where  Described 

sound  force  veh  spec  sound 

Sections  2.1.3  2.3,  2.1. 3.3.3,  and  2.1. 3.4.3 

Table  2.1*349:  sound_force_const_sound  Information. 
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2. 1.3. 1.4  sound_make_var_sound 

This  routine  determines  which  vaiiable  sounds  are  to  be  made,  and  calls  the  vehicle  specific 
code  to  interface  with  the  sound  system.  An  example  of  a  variable  sound  is  the  engine 
noise,  whose  pitch  varies  with  Ae  speed  of  the  vehicle  and  the  terrain.  The  parameter 
soundjndex  is  an  index  into  the  sound  array  in  the  vehicle  specific  code,  pet  is  the  percent 
of  the  pitch  range  at  which  the  sound  is  to  be  made.  Note  that  the  vehicle  specific  code 
actually  makes  the  sound  with  the  string  passed  by  this  routine. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

sound  index 

int 

Standard 

DCt 

REAL 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

mod 

int 

Standard 

bufllOl 

char 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

TRUE 

int 

the  sound  index  is  valid 

FALSE 

int 

the  sound  index  is  invalid 

1  Calls  1 

Function 

Where  Described 

sound  make  veh  spec  sound 

Sections  2.1. 3.2.2.  2.1. 3.3.2.  and  2.1. 3.4.2 

Table  2.1-350:  sound  make  var  sound  Information. 


2 . 1 .3 . 1 .5  sound_get_var_sound_arg 


This  routine  determines  the  modifier,  mod,  that  is  used  to  vary  the  sound  instead  of  a 
percent. 


I  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

sound  index 

int 

Standard 

pet 

REAL 

Standard 

mod 

pointer  to  int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

veh_sou  nd_array[sound_ 
index]. last_mod  !=  *mod 

int 

modifier  to  send  to  the  sound 
system 

Table  2.1-351;  sound_get_var_sound_arg  Information. 
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2. 1.3. 1.6  sound_make_arg_sound 


This  routine  determines  the  variable  sound  to  be  made  ^ven  the  index  into  the  sound  array, 
soundjndex,  and  the  modifier,  mod.  The  vehicle  specific  code  is  called  to  interface  with 
the  sound  system. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

sound  index 

int 

Standard 

mod 

int 

Standard 

Internal  Variables 


Variable 

Where  Tvpedef  Declared 

bum  01 

char 

Standard 

1  Calls  1 

Function 

Where  Described 

sound  make  veh  soec  sound 

Sections  2.1. 3.2.2.  2.1. 3.3.2.  and  2.1. 3.4.2 

Table  2.1*352:  sound_make_arg_sound  Information. 


2. 1.3. 1.7  sound  make  del  sound 


This  routine  makes  a  delayed  sound.  It  has  timers  call  this  routine  after  a  certain  delay. 
The  argument  for  this  routine  is  passed  by  the  timers  library. 


1  Calls  1 

Function 

Where  Described 

timers  qet  data 

Section  2.6.3.3.1 

sound  make  const  sound 

Section  2. 1.3. 1.2 

Table  2.1*353:  sound  make  del  sound  Information. 


2. 1.3. 1.8  sound_force_del_sound 


This  routine  forces  a  delayed  sound,  regardless  of  the  timing  and  of  whether  the  vehicle 
specific  code  disallows  the  sound. 


1  Calls  1 

Function 

Where  Described 

sound  force  const  sound 

Section  2.1. 3. 1.3 

timers  aet  data 

Section  2.6.3.3.1 

Table  2.1*354:  sound_force_del_sound  Information. 
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2. 1.3. 1.9  sound  make  cont  sound 


This  routine  combines  different  sounds  into  a  continuous  sound.  For  example,  it  ensures 
that  the  different  components  of  the  engine  sound  (startup  sound,  running  sound,  and 
stopping  sound)  are  made  without  any  breaks,  start  index  is  the  index  into  the  sound  anay 
for  die  starting  sound;  vary  index  is  Ae  index  into  the  sound  array  for  a  variable  sound; 
stopjndex  is  the  index  into  the  sound  array  for  the  stopping  sound;  pet  is  the  percent  for 
varying  the  variable  pitch  sound. 


I  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

start  index 

int 

Standard 

vary  index 

int 

Standard 

stop  index 

int 

Standard 

pet 

REAL 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

mod 

int 

Standard 

lenoth 

int 

Standard 

butnoi 

char 

Standard 

1  Return  Values  1 

Return  Value 

Tvpe 

Meanina 

FALSE 

int 

no  sound  was  made 

TRUE 

int 

a  sound  was  made 

1  Calls  1 

Function 

Where  Described 

sound  make  veh  spec  sound 

Sections  2.1. 3.2.2,  2.1. 3.3.2,  and  2.1. 3.4.2 

Table  2.1-355:  sound  make  cont  sound  Information. 
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2.1.3.1.10  sound_stop_cont_sound 
Hiis  routine  stops  a  continuous  sound. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

stop  index 

int 

Standard 

vary  index 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

length 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

sound  make  veh  spec  sound 

Sections  2.1. 3.2.2.  2.1. 3.3.2.  and  2.1. 3.4.2 

Table  2.1*356:  sound_stop_cont_sound  Information. 
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2. 1.3. 2  ml  sound.c 

(./simnet^lease/src/vehicIe/ml/ml_sound.c  [ml_sound.c]) 

Includes; 

"stdio.h" 

"ctype.h" 

"signal.h" 

"sim_dfns.h" 

"sim_macros.h" 

"fifo_dfn.h" 

’Tifo.h" 

"mass_stdc.h" 

''dgi_stdg.h" 

"timers.h" 

Ocfincs! 

TICKS_BETWEEN_RANDOM_SOUNDS 

MAX_NUMBER_OF_RANDOM_SOUNDS 

CAT_KILL_DELAY 

SOUND_PORT_NUM 

DRIVING_ON_ROAD_FACTOR 

NO_TRAVERSE 

ELECTRIC_TRAVERSE 

HYDRAULIC_TRAVERSE 

Declarations: 

veh_sound_airay  -  The  listing  of  all  possible  sounds  the  vehicle  can 

make.  Each  sound  is  listed  as  an  index  into  the 
array. 

soil_type  --  The  current  soil  type 

turret_traverse_state  --  The  turret  traverse  state 
counter  --  A  counter  for  timeouts  on  random  sounds 

sound.index  --  Pointer  into  the  sound  array 

gun_is_elevating  --  Flag  for  elevation  sounds 

gun_is_hitting_stop  --  Flag  for  hitting  stops 
track_speed_factor  --  Fraction  of  max  truck  speed 

dont_use_sound  -  Set  to  zero  if  sounds  arc  to  be  used 

sound_of_random_sounds() 
sound~denial_che^() 

soundjarray  ~  --  The  array  of  random  sounds 


"sim_cig_if.h" 

"UbfaiLh" 

”libidc_dfn.h" 

"libsound.h" 

"libsound_dfn.h" 

'‘ml_mem_dfn.h" 

"ml_sound.h" 

"ml_sound_dfn.h" 

"timers_dfn.h'’ 
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2. 1.3.2. 1  sound_deniaI_check 

This  routine  returns  TRUE  if  the  sound  system  is  not  used.  Access  to  the  sound  system  is 
denied  if  the  dontjise_sound  flag  is  equal  to  1,  if  the  vehicle  was  destroyed,  or  if 
siiii_state  sounds_deniedO  returns  FALSE.  The  dont_use_s6und  flag  is  set  from  the 
ctHnmandline.  ~ 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

TRUE 

int 

The  use  of  sounds  is  denied 

FALSE 

int 

The  use  of  sounds  is  not 
denied 

Calls 

Function 

Where  Described 

fail  death  status 

Section  2.5.4.10.1 

Sim  state  sounds  denied 

Section  2.5.1.1.12 

Table  2.1*357:  sound  denial  check  Information. 


2 . 1 . 3 . 2 . 2  sound_make_veh_spec_sound 


This  routine  takes  a  sound  request  string,  sound  str,  of  length  str  jen  from  the  sound 
library  and  requests  the  sound  from  the  sound  system.  The  routine  checks  if  access  to  the 
sound  system  is  allowed,  and  queues  the  sound  request  to  the  fifo. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

sound  str 

array  of  char 

Standard 

str  len 

int 

Standard 

Calls 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.2.1 

fifo  enoueue 

Section  2.6.8.2.1 

Table  2.1*358:  sound_make_veh_spec_sound  Information. 
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2 . 1 . 3 . 2 . 3  sound^for  ce_veh_spec_sound 


This  routine  takes  a  sound  request,  sound  str,  from  the  sound  library  and  requests  the 
sound  fiom  the  sound  system.  The  routine  checks  if  access  to  the  sound  system  is 
allowed,  and  queues  die  sound  request  to  the  Mo.  Access  to  the  sound  system  may  only 
be  restricted  from  the  command  line. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

sound  str 

array  of  char 

Standard 

str  len 

int 

Standard 

Calls 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.2.1 

fifo  enaueue 

Section  2.6.8.2.1 

Table  2.1-359:  sound_force_veh_spec_sound  Information. 


2. 1.3. 2. 4  soundjnit 

This  routine  checks  if  access  to  the  sound  system  is  allowed,  initializes  the  flfo,  and  resets 
the  sound  system. 


1  Calls  1 

Function 

Where  Described 

fifo  init 

Section  2.8.6.3.1 

sound  reset 

Section  2.1. 3.2.7 

Table  2.1-360:  sound  init  Information. 


2. 1.3. 2. 5  sound  dont  use 


This  routine  sets  the  dont jise  sound  flag  to  1  and  prints  the  statement  "Sound  is  turned 
off. 


2. 1.3. 2. 6  sound_simul 

This  routine  runs  the  sound  simulation.  It  checks  if  access  to  the  sound  system  is  allowed, 
queues  sounds  to  the  Mo,  and  calls  for  random  sounds  to  be  made. 


1  Calls  1 

Function 

Where  Described 

fifo  enaueue 

Section  2.8.8.2.1 

sound  of  random  sounds 

Section  2.1.3.2.12 

Table  2.1-361:  sound  simul  Information. 
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This  routine  checks  if  access  to  the  sound  system  is  allowed  and  resets  the  sound  system. 


1  Calls  1 

Function 

Where  Described 

fifo  enaueue 

Section  2.6.8.2.1 

Table  2.1-362:  sound  reset  Information. 


2. 1.3. 2. 8  sound_we  just_died 


This  routine  resets  the  sound  system.  At  a  later  tick,  the  sound  of  catastrophic  kill  is 
requested. 


1  Calls  1 

Function 

Where  Described 

sound  reset 

Section  2.1. 3.2.7 

Section  2.6.3.4.1 

Table  2.1-363:  sound_we_Just_died  Information. 


2. 1.3. 2. 9  sound_of_tracks 

This  routine  makes  the  sound  of  the  tracks  starting,  stopping,  and  moving,  based  on  the 
soil  type  and  the  track  speed. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

tract  ion_of_max_speed 

REAL 

/simnet/common/include 
/qlobal/sim  types.h 

new  soil  tvpe 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

temp  tracks  speed 

int 

Standard 

sound  of  tread  start 

int 

Standard 

sound  of  tread  stop 

int 

Standard 

sound  of  vary  tread 

int 

Standard 

sound  of  vary  other  tread 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

sound  aet  var  sound  arq 

Section  2. 1.3.1. 5 

sound  make  const  sound 

Section  2.1. 3.1 .2 

sound  make  arq  sound 

Section  2. 1.3. 1.6 

Table  2.1-364:  sound_of_tracks  Information. 
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2.1.3.2.10  sound_of_turret_tra versing 

This  routine  makes  the  sound  of  the  tuiiet  starting,  stopping  and  traversing,  based  on 
whether  the  turret  is  under  hydraulic  or  electric  traverse  control. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

traversina 

int 

Standard 

palm  release  or  hydraulic 

int 

Standard 

fraction 

REAL 

/simnet/common/include 
/Qlobal/sim  tvpes.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

new  traverse  state 

reaister  int 

Standard 

1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2.1. 3.1. 2 

sound  make  var  sound 

Section  2. 1.3. 1.4 

Table  2.1-365:  sound_of_turret_traversing  Information. 


2.1.3.2.11  sound_of_gun_elevating 

This  routine  makes  the  sounds  of  the  gun  starting  to  elevating,  elevating,  and  hitting  the 
elevation  stops. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

fraction_of_max_speed 

REAL 

/simnet/common/include 
/Qlobal/sim  tvpes.h 

temp  hittinq  stop 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

sound  make  const  sound 

Section  2.1. 3. 1.2 

Table  2.1-366:  sound_of_gun_elevating  Information. 
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2.1.3.2.12  sound_of_randoiii_soun ds 

This  routine  makes  the  random  squeak,  rattle,  and  bump  sounds. 


1  Calls  1 

Function 

Where  Described 

roll  dice 

/simnet/common/include/Qlobal/sim  macros.h 

sound  make  const  sound 

Section  2.1. 3.1. 2 

Table  2.1-367:  sound_of_random_sounds  Information. 
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2. 1.3.3  m2  sound.c 

(./simnet;^lease/sic/vehicle/ni2/m2_sound.c  [m2_sound.c] ) 


Includes: 


"stdio.h" 

"ctype.h" 

"signal.h" 

"sim_dfns.h" 

"sim_macros.h" 

"fifo_dfn.h" 

''mass_stdc.h" 

"dgi_stdg.h" 

"timers.h" 


"sini_cig_if.h" 

“UbfaiLh" 

"libidc_dfn.h" 

"Ubsound.h" 

"libsound_dfn.h" 

"m2_mem_dfn.h" 

"in2_sound.h" 

''m2_sound_dfn.h" 

"timers_dfn.h" 

”sim_types.h” 


Defines: 

TICKS_BETWEEN_RANDOM_SOUNDS 

MAX_NUMBER_OF_RANDOM_SOUNDS 

CAT_KILL_DELAY 

SOUND_PORT_NUM 

DRIVING_ON_ROAD_FACTOR 

TRAVERSE_ABRUPT_STOP_SPEED 

MAIN_GUN_FIRING_DELAY 

FAST_TRAV_ABRUPT_STOP_DELAY 

FAST_TRAV_NORMAL_STOP_DELAY 

SLOW  TRAV_ABRUPT_STOP_DELAY 

S1jOW_TRAV_NORMAL_STOP_DELAY 

TURRET_DRIVE_OFF_DELAY 

engine_cranking_stop_delay 

ENGINE  STALLING.DELAY 

ENGINE_RUNNING_STOP_DELAY 

TURRET_POWER_PRIORITY 

TURRET_DRIVE_PRIORITY 

TURRET_TRAVERSE_PRIORnY 

ENGINE_ACCESSORY_PRIORITY 

ENGINE_RUNNING_PRIORITY 


Declarations: 

veh_sound_array 


soiLtype 

counter 

sound_index 

gun_is_fast_elevating 

gun_is_slow_elevating 

gun_is_hitting_stops 

turret_is_fast_traversing  -- 

turret_is_slow_traversing  - 

old_traverse_speed 

track_speed_factor 

main _gun_firing_counter  - 

tmTet_drive_should_be_on 


The  listing  of  all  possible  sounds  the  vehicle  can 
make.  Each  sound  is  listed  as  an  index  into  the 
array. 

The  current  soil  type 

A  counter  for  timeouts  on  random  sounds 

Pointer  into  the  sound  array 

Flag  for  fast  elevate  sounds 

Flag  for  slow  elevate  sounds 

Flag  for  hitting  stops 

Flag  for  fast  traverse  sounds 

Flag  for  slow  traverse  sounds 

For  traverse  abrupt  stop 

Fraction  of  max  track  speed 

For  choosing  firing  sound 

For  queueing  on  channel  2 
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turret_power_should_be_on  For  queueing  on  channel  2 

channel_2_prioiity  -  For  queueing  on  channel  2 

channel_2_counter  --  For  queueing  on  channel  2 

engine_accessory_should_be_on  For  queueing  on  channel  5 

channel_5_priority  --  For  queueing  on  channel  5 

channel_5_counter  -  For  queueing  on  channel  5 

dont_use_sound  --  Set  to  zero  if  sounds  are  to  be  used 

sound_of_randoin_sounds() 

sound~denial_che^() 

sound~of_turret_power_already_on() 

sound~of”turret“drive_already_on() 

sound^of” engine  accessory_already_on() 

channel_J_checkO  ” 

channel~5~check0 

sound_aifa^  --  The  array  of  random  sounds 


2. 1.3. 3.1  sound_denial_check 

This  routine  returns  TRUE  if  the  sound  system  is  not  used.  Access  to  the  sound  system  is 
denied  if  the  dontjtse  sound  flag  is  equsd  to  1,  if  the  vehicle  was  destroyed,  or  if  the 
sini_state  sounds_deniedO  returns  FALSE.  The  dont  use  sound  flag  is  set  from  the 
command  Ene. 


1  Return  Values  1 

Return  Value 

Meaning 

TRUE 

int 

The  use  of  sounds  is  denied 

FALSE 

int 

The  use  of  sounds  is  not 
denied 

1  Calls  1 

Function 

Where  Described 

fail  death  status 

Section  2.5.4.10.1 

Sim  state  sounds  denied 

Section  2.5.1.1.12 

Table  2.1-368: 
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2 . 1 . 3 . 3 . 2  soun  d_make_veh_spec_sound 


This  routine  takes  a  sound  request,  sound  str,  from  the  sound  library  and  requests  the 
sound  from  the  sound  system.  The  routine  checks  if  access  to  the  sound  system  is 
allowed,  and  queues  the  sound  request  to  the  fifo. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

sound  str 

array  of  char 

Standard 

str  ten 

int 

Standard 

Calls 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.3.1 

fifo  enaueue 

Section  2.6.8.2.1 

Table  2.1-369:  sound_make_veh_spec_sound  Information. 


2. 1.3. 3. 3  sound_force_veh_spec_sound 

This  routine  takes  a  sound  request,  sound_str,  from  the  sound  library  and  requests  the 
sound  from  the  sound  system.  The  routine  checks  if  access  to  the  sound  system  is 
allowed,  and  queues  the  sound  request  to  the  fifo.  Access  to  the  sound  system  may  only 
be  disallowed  at  the  command  line. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

sound  str 

array  of  char 

Standard 

str  len 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.3.1 

fifo  enqueue 

Section  2.6.8.2.1 

Table  2.1-370:  sound_force_veh_spec_sound  Information. 


2. 1.3. 3. 4  sound  init 


This  routine  checks  if  access  to  the  sound  system  is  allowed,  initializes  the  fifo,  and  resets 
the  sound  system. 


1  Calls  1 

Function 

Where  Described 

fifo  init 

Section  2.8.8.3.1 

sound  reset 

Section  2.1. 3.3.7 

Table  2.1-371:  sound  init  Information. 
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2. 1.3. 3. 5  sound_dont_use 

This  routine  sets  the  dont  use  sound  flag  to  1  and  prints  the  statement  "Sound  is  turned 
off. 


2. 1.3. 3. 6  sound_simul 

This  routine  runs  the  sound  simulation.  It  checks  if  access  to  the  sound  system  is  allowed, 
queues  sounds  to  the  Hfo,  calls  for  random  sounds  to  be  made,  monitors  the  channel  2 
sound  port  and  the  channel  5  sound  port,  and  decrements  the  main  gun  firing  counter. 


1  Calls  1 

Function 

Where  Described 

fifo  enqueue 

Section  2.6.8.2.1 

sound  of  random  sounds 

Section  2.1. 3.3.7 

channel  2  check 

Section  2.1.3.3.29 

channel  5  check 

Section  2.1.3.3.30 

Table  2.1-372:  sound  simul  Information. 


2. 1.3. 3. 7  sound  reset 

This  routine  checks  if  access  to  the  sound  system  is  allowed  and  resets  the  sound  system. 


1  Calls  1 

Function 

Where  Described 

fifo  enqueue 

Section  2. 6.8. 2.1 

Table  2.1-373:  sound  reset  Information. 


2. 1.3. 3. 8  sound_we  _just_died 

This  routine  resets  the  sound  system.  At  a  later  tick,  the  sound  of  catastrophic  kill  is 
requested. 


1  Calls  1 

Function 

Where  Described 

sound  reset 

Section  2. 1.3.3. 7 

timers  delay  oroc 

Section  2.6.3.4.1 

Table  2.1-374:  sound_we_just_died  Information. 
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2. 1.3. 3. 9  sound_of_maln_gun_firing 


This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
main  gun  firing.  The  number  of  times  the  sound  is  made  is  based  on  the  status  of  the  main 
gun  fimg  counter,  which  depends  on  whether  the  gun  is  in  continuous  or  single  shot 
mode. 


1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1 .3.3.1 

sound  make  const  sound 

Section  2. 1.3.1. 2 

Table  2.1-375:  sound_of_main_gun_firing  Information. 


2.1.3.3.10  sound_of_engine_cranking_start 

This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
engine  cranking  being  started.  The  sound  of  the  start  of  the  engine  cranking  is  given  high 
priority  on  Channel  5. 


1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.3.1 

sound  make  const  sound 

Section  2.1. 3. 1.2 

Table  2.1-376:  sound_of_englne_cranking_start  Information. 


2.1.3.3.11  sound_of_engine_cranking_stop 

This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
engine  cranking  being  stopped.  The  sound  of  the  engine  crmtidng  stop  is  given  high 
priority  on  Channel  5. 


1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2. 1.3. 3.1 

sound  make  const  sound 

Section  2. 1.3.1. 2 

Table  2.1-377:  sound_of_engine_cranking_stop  Information. 
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2.1.3.3.12  sound_of_engine_cranking_stall 

This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
engine  cranking  stalling.  The  sound  of  the  engine  cranking  stall  is  given  high  priority  on 
Channel  5. 


1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.3.1 

sound  make  const  sound 

Section  2.1. 3.1. 2 

Table  2.1-378:  sound_of_engine_cranking_stall  Information. 


2.1.3.3.13  sound_of_tracks 

This  routine  makes  the  sound  of  the  tracks  starting,  stopping,  and  moving,  based  on  the 
soil  type  and  the  vehicle  speed. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

lraction_of_max_speed 

REAL 

/simnet/common/include 
/Qlobal/sim  types. h 

new  soil  type 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Tvoedef  Declared 

temp  tracks  speed  * 

int 

Standard 

sound  of  tread  start 

int 

Standard 

sound  of  tread  stop 

int 

Standard 

sound  of  vary  tread 

int 

Standard 

sound  of  vary  other  tread 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

sound  aet  var  sound  ara 

Section  2.1 .3.1.5 

sound  make  const  sound 

Section  2. 1.3. 1.3 

sound  make  ara  sound 

Section  2.1 .3.1. 6 

Table  2.1-379:  sound_of_tracks  Information. 
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2.1.3.3.14  sound_of_engine_start 


This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
engine  starting.  The  sound  of  the  engine  start  is  given  a  high  priority  on  Channel  5. 


1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1 .3.3.1 

sound  make  const  sound 

Section  2.1 .3.1. 2 

Table  2.1-380:  sound_of_engine_start  Information. 


2.1.3.3.15  sound_of_engine__stop 

This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
engine  stopping.  The  sound  of  the  engine  stop  is  given  a  high  priority  on  Channel  5. 


1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.3.1 

sound  make  const  sound 

Section  2.1. 3.1. 2 

Table  2.1-381:  sound_of_engine_stop  Information. 


2.1.3.3.16  sound_of_engine 

This  routine  makes  the  sound  of  the  engine. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

fraction_of_max_speed 

REAL 

/simnet/common/include 
/alobal/sim  tvoes.h 

1  Calls  1 

Function 

Where  Described 

sound  make  const,  sound 

Section  2.1. 3.1. 2 

Table  2.1-382:  sound_of_engine  Information. 
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2.1.3.3.17  sound_of_gun_elevating 

This  routine  makes  the  sounds  of  the  gun  elevating  and  hitting  the  elevation  stops,  based  on 
whether  the  gun  is  elevating  quickly  or  slowly. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fraction_of_max_speed 

REAL 

/simnet/common/include 
/alobal/sim  tvpes.h 

temp  hittina  stop 

int 

Standard 

tempjast 

BOOLEAN 

/simnet/common/include 
/alobal/sim  tvoes.h 

Calls 

Function 

Where  Described 

sound  make  const  sound 

Section  2. 1.3.1. 2 

Table  2.1-383:  sound_of_guii_elevating  Information. 


2.1.3.3.18  sound_of_turret_t raversing 


This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
turret  traversing  and  stopping,  based  on  whether  the  turret  is  moving  slowy  or  quickly  and 
whether  the  stop  is  norm^  or  abrupt.  The  priority  level  of  Channel  2  is  checked  before 
making  the  sound. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

fraction_of_max_speed 

REAL 

/simnet/common/include 
/alobal/sim  tvpes.h 

tempjast 

BOOLEAN 

/simnet/common/include 
/alobal/sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.3.1 

fifo  enqueue 

Section  2.6.8.2.1 

sound  make  const  sound 

Section  2.1. 3. 1.2 

Table  2.1-384:  sound_of_turret_traversing  Information. 
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2. 1 .3.3 . 19  sound_of_turret_power_on 

This  routine  checks  if  access  tt)  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
tuiietpo>wer  being  on.  Note  that  the  turret  power  sound,  turret  drive  sound,  and  turret 
traverse  sound  are  all  on  Channel  2  with  different  priorities.  The  low  priority  sounds  will 
be  turnsd  on  once  die  higher  priority  sounds  are  turned  off. 


1  Calls  1 

Functienn 

Where  Described 

sound  fSenial  check 

Section  2.1. 3.3.1 

sound  rmake  const  sound 

Section  2.1. 3.1. 2 

Table  2.1-385:  sound_of_turret_power_on  Information. 


2. 1 .3.3 .20  sound_of_turret_power_already_on 

This  iDuaine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
turret  pcrwer  already  being  on.  The  priority  level  of  Channel  2  is  checked  before  making 
the  sound. 


1  Calls  1 

Function 

Where  Described 

sound  dtenial  check 

Section  2.1 .3.3.1 

sound  rraake  const  sound 

Section  2. 1.3.1. 2 

Table  2.1-386:  sound_of_turret_power_already_on  Information. 


2 . 1.3.3 . 2 1  sound_of_turret_power_off 

This  lonttine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
turret  p®wer  being  off.  The  priority  level  of  Channel  2  is  checked  before  making  the 
sountL 


1  Calls  1 

Function 

Where  Described 

sound  c&enial  check 

Section  2.1. 3.3.1 

sound  n^ake  const  sound 

Section  2. 1.3. 1.2 

Table  2.1-387:  sound_of_turret_power_off  Information. 
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2.1.3.3.22  sound_of_turret_drive_oii 

This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
turret  drive  being  turned  on.  The  priority  level  of  Chaimel  2  is  checked  before  making  the 
sound. 


1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.3.1 

sound  make  const  sound 

Section  2.1 .3.1. 2 

Table  2.1>388:  sound_of_turret_drive_on  Information. 


2.1.3.3.23  sound_of_turret_dri ve_aIready_on 

This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
turret  drive  already  being  on.  The  priority  level  of  Channel  2  is  checked  before  making  the 
sound. 


1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.3.1 

sound  make  const  sound 

Section  2.1. 3.1. 2 

Table  2.1-389:  sound_of_turret_drive_aIready_on  Information. 


2.1.3.3.24  sound_of_turret_drive_off 

This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
turret  drive  being  turned  off.  The  priority  level  of  Channel  2  is  checked  before  making  the 
sound. 


1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.3.1 

sound  make  const  sound 

Section  2.1. 3.1. 2 

Table  2.1-390;  sound_of_turret_drive_off  Information. 
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2.1.3.3.25  sound__of_engine_accessory_on 

This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
ei^ime  accessory  being  mmed  on.  The  priority  level  of  Channel  5  is  checked  before 
ma&ding  the  sound. 


1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1 .3.3.1 

sound  make  const  socund 

Section  2.1 .3.1.2 

Table  2.1-391:  sound_of_engine_accessory_on  Information. 


2.1.3.3.26  souBd__of_engine__accessory_aIready_on 

This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
engiaie  accessory  already  being  on.  The  priority  level  of  Channel  5  is  checked  before 
making  the  sound. 


1  Calls  1 

Function 

Where  Described 

sourud  denial  check 

Section  2.1. 3.3.1 

sound  make  const  sound 

Section  2.1 .3.1.2 

Table  2.1-392: 


sound_of_engine_accessory_already_on  Information. 


2.1.3.3.27  soun«l_of_engine_accessory_of f 

This  routine  checks  if  access  to  the  sound  system  is  allowed,  and  makes  the  sound  of  the 
engine  accessory  bdng  turned  off.  The  priority  level  of  Channel  5  is  checked  before 
making  the  sound. 


1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.3.1 

sound  make  const  sound 

Section  2.1. 3.1. 2 

Table  2.1-393;  sound_of_engine_accessory_off  Information. 
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2.1.3.3.28  sound_of_randoin_sounds 

This  routine  makes  the  random  squeak,  rattle,  and  bump  sounds. 


1  Calls  1 

Function 

Where  Described 

roll  dice 

/simnet/common/include/Qlobat/sim  macros.h 

sound  make  const  sound 

Section  2.1. 3.1. 2 

Table  2.1«394:  sound_of_random_sounds  Information. 


2.1.3.3.29  channel_2_check 

This  routine  checks  the  priority  level  of  Channel  2. 


1  Calls  1 

Function 

Where  Described 

sound  of  turret  drive  already  on 

Section  2.1.3.3.20 

sound  of  turret  power  already  on 

Section  2.1.3.3.19 

Table  2.1-395:  channel  2  check  Information. 


2.1.3.3.30  channel_5_check 

This  routine  checks  the  priority  level  of  Channel  5. 


1  Calls  1 

Function 

Where  Described 

sound  of  enaine  accessory  already  on 

Section  2.1.3.3.26 

Table  2.1-396:  channel  5  check  Information. 
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2. 1.3.4  kato  sound.c 

(./simnet/reTease/src/vehicle/kato/kato_sound.c  [kato_sound.c]) 

Includes: 

"stdio.h" 

"ctype.h" 

"math.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"basic.h" 

"obj_type.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"kato_mem_dfn,h" 

"kato_snd_dfn.h" 

Defines  t 

S_MAX_TRACKS_SPEED_SOUND 

S_MAX_ENGINE_SPEED_SOUND 

MAX_STEALTH_SPEED_SOUND 

MAX_STEALTH_VEL 

MAX_TANK_VEL 

MAX_APC_VEL 

max_engine_speed 

TICKS_BETWEEN_RANDOM_SOUNDS 

MAX_NUMBER_OF_RANDOM_SOUNDS 

CAT_KILL_PELAY 

SOUND_PORT_NUM 

Declaradons: 

veh_sound_aiTay  --  The  listing  of  all  possible  sounds  the  vehicle  can 

make.  Each  sound  is  listed  as  an  index  into  the 
array. 

engine_start_index 

engine_vary_index 

engine_stop_index 

actuator_start_index 

actuator_vary_index 

actuator_stop_index 

vel_pct 

track_speed  -  Sound  system  speed 

engine_speed  --  Last  engine  speed 

stealth_speed 

counts*  --  A  counter  for  timeouts  on  random  sounds 

sound_index  -  Pointer  into  the  sound  array 

track_speed_factor  -  Fraction  of  max  track  speed 

dont_use_sound  --  Set  to  zero  if  sounds  are  to  be  used 

sound_of_random_sounds() 
sound”denial_check() 

soundjarray  -  The  array  of  random  sounds 


"sim_cig_if.h" 

"fifo_dfn.h" 

"fifo.h" 

"libsound.h" 

•’libsound_dfn.h" 

"libmatrix.h" 

•libfaiLh" 

"Ubidc_dfn.h" 

"timers_dfn.h" 

"timers.h" 

"kato_sound.h" 
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2. 1.3. 4.1  sound_denial_check 

This  routine  returns  TRUE  if  the  sound  system  is  not  used.  Access  to  the  sound  system  is 
denied  if  the  dont_use_sound  flag  is  equ^  to  1,  if  the  vehicle  was  destroyed,  or  if  the 
siin_state  sounds_deniedO  returns  FALSE.  The  dont_use_somd  flag  is  set  from  the 
cotnmand  Hne.  " 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

The  use  of  sounds  is  denied 

FALSE 

int 

The  use  of  sounds  is  not 
denied 

Calls 

Function 

Where  Described 

fail  death  status 

Section  2.5.4.10.1 

Sim  state  sounds  denied 

Section  2.5.1.1.12 

Table  2.1-397:  sound  denial  check  Information. 


2 . 1 . 3 . 4 . 2  soun  d_make_veh_spec_sound 

This  routine  takes  a  sound  request,  sound  str,  from  the  sound  library  and  requests  the 
sound  from  the  sound  system.  The  routine  checks  if  access  to  the  sound  system  is 
allowed,  and  queues  the  sound  request  to  the  fifo. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

sound  str 

array  of  char 

Standard 

str  len 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.4.1 

fifo  enqueue 

Section  2.6.8.2.1 

Table  2.1-398:  sound_make_veh_spec_sound  Information. 


333 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2 . 1 . 3 . 4 . 3  sound_force_veh_spec_sound 

This  routine  takes  a  sound  request,  sound  str,  from  the  sound  library  and  requests  the 
sound  from  the  sound  system.  The  routine  checks  if  access  to  the  sound  system  is 
allowed,  and  queues  the  sound  request  to  the  frfo.  Access  to  the  sound  system  may  only 
be  disallowed  at  the  command  line. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

sound  str 

array  of  char 

Standard 

str  len 

int 

Standard 

Calls 


Function 

Where  Described 

sound  denial  check 

Section  2.1. 3.4.1 

fifo  enqueue 

Section  2.6.8.2.1 

Table  2.1-399:  sound_force_veh_spec_sound  Information. 


2. 1.3. 4. 4  sound  ink 


This  routine  checks  if  access  to  the  sound  system  is  allowed,  initializes  the  fifo,  and  resets 
the  sound  system. 


1  Calls  1 

Function 

Where  Described 

fifo  init 

Section  2.6.8.3.1 

sound  reset 

Section  2.1 .3.3.7 

Table  2.1-400:  sound  init  Information. 


2. 1.3. 4. 5  sound_dont_use 

This  routine  sets  the  dont_use_sound  flag  to  1  and  prints  the  statement  "Sound  is  turned 
off". 

2. 1.3. 4. 6  sound  simul 


This  routine  runs  the  sound  simulation.  It  checks  if  access  to  the  sound  system  is  allowed, 
queues  sounds  to  the  flfo,  and  calls  for  random  sounds  to  be  made. 


1  Calls  1 

Function 

Where  Described 

fifo  enqueue 

Section  2.6.8.2.1 

sound  of  random  sounds 

Section  2.1.3.3.28 

Table  2.1-401:  sound  simul  Information. 
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2. 1.3. 4. 7  sound  reset 

This  routine  checks  if  access  to  the  sound  system  is  allowed  and  resets  the  sound  system. 


1  Calls  1 

Function 

Where  Described 

fifo  enqueue 

Section  2.6.8.2.1 

Table  2.1-402:  sound  reset  Information. 


2. 1.3. 4. 8  sound_we_just_died 

This  routine  resets  the  sound  system.  At  a  later  tick,  the  sound  of  catestrophic  kill  is 
requested. 


1  Calls  1 

Function 

Where  Described 

sound  reset 

Section  2.1. 3.3.7 

Section  2.6.3.4.1 

Table  2.1-403:  sound_we _just_died  Information. 


2. 1.3. 4. 9  sound_^of_vehicle 

This  routine  makes  the  sound  of  the  vehicle  to  which  the  Stealth  vehicle  is  attached. 


1  Parameters  i 

Parameter 

Where  Typedef  Declared 

guise 

ObjectType 

/simnet/common/include 
/orotocol/D  sim.h 

eng_speed 

REAL 

/simnet/common/include 
/qlobal/sim  types.h 

velocity 

VECTOR 

/simnet/common/include 
/qlobal/sim  types.h 

1  Calls  1 

Function 

Where  Described 

sound  stoD  cont  sound 

Section  2.1.3.1.10 

sound  make  cont  sound 

Section  2. 1.3. 1.2 

vec  dot  prod 

Section  2.6.2.54.1 

Table  2.1-404:  sound_of_vehicle  Information. 
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2.1.3.4.12  soii9B!d_of_random_sounds 
This  routine  makes  die  random  sounds. 


1  Calls  1 

Function 

Where  Described 

roll  dice 

/simnet/common/include/olobal/sim  macros.h 

sound  make  const  sound 

Section  2.1. 3.1. 2 

Table  1.1<405:  sound_of_random_sounds  Information. 
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2.1.4  Controls  Interface  Software 

Controls  are  defined  as  the  operator  interface  to  the  simulation.  The  controls  are  composed 
of  analog  and  digital  inputs  and  outputs  (toggle  switches,  steering  wheels,  lights,  meters, 
etc.).  Tlus  CSC  contains  the  routines  which  interface  with  these  devices.  The  structure  of 
this  CSC  is  displayed  in  Figure  2.1-5.  This  CSC  consists  of  two  third  level  CSCs, 
Controls  Using  IDC  Boards  and  High  Performance  Analog  Interface. 


Controls  Interface 
Software 

5.1.4 


Controls 

Using 

IDC  Boards 
5.1. 4.1 


libido 

5.1.4.1.1 

libpots 

5. 1.4. 1.2 

mljdc.c 

5.1. 4.1. 3 

m2Jdc.c 

5.1 .4.1.4 

kato_idc.c 

5.1. 4.1. 5 


High 

Performance 

Analog 

Interface 

5.1. 4.2 


libdtad 
5.1. 4.2.1 


Figure  2.1*5  Controls  Interface  Software  structure 


2. 1.4.1  Controls  using  IDC  Boards 

An  asynchronous  interface  was  designed  to  link  the  analog  and  digital  inputs  and  outputs  to 
the  simulation  host  The  simulation  communicates  over  RS232  serial  lines  which  connect 
to  IDC  boards  which  provide  an  interface  to  the  control  panels.  The  software  interface 
between  analog/digitd  inputs  and  the  simulation  is  through  a  shared  memory  segment; 
therefore,  when  an  input  device  changes  position,  data  in  a  corresponding  shared  memory 
location  changes  value.  The  simulation  drives  outputs  (indicators,  meters,  lights)  by 
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writing  to  the  fifo  utility  described  in  section  2.6.8.  Several  routines  (libidc,  ml_idc.c, 
in2_i(k.c,  kato_idc.c)  exist  to  deal  directly  with  the  shared  memory  segment.  These 
routines  initialize  the  memory  locations  and  provide  access  to  the  data  contained  in  shared 
memory.  The  library  libpots  was  created  to  convert  the  hexidecimal  number  that  appears  in 
the  sha^  memory  segment  to  a  useable  value.  All  the  potentiometers  used  during  the 
simulation  are  calibrated  off-line  and  their  limits  are  saved  in  a  file.  Libpots  takes  the  limit 
values  and  the  current  pot  value,  and  returns  real  numbers  in  the  format  that  the  simulation 
can  use  (e.i.,  a  REAL  ^tween  0  and  1  or  between  -1  and  1,  depending  on  the  nature  of  the 
control  device).  Five  CSUs  are  associated  with  this  CSC; 


libidc 

libpots 

mljdc.c 

m2_idc.c 

kato_idc.c 
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2. 1.4. 1.1  libidc 

(ysimnet/release/src/libsrc/libidc  [libidc]) 

This  libr^  contains  routines  which  deal  directly  with  the  shared  memory  segment.  These 
routines  initialize  the  memory  locations  and  provide  access  to  the  data  contained  in  shared 
memory. 


2. 1.4. 1.1.1  choose_fifo.c 

(./simnet/release/src/libsrc/libidc/choose_fifo.c) 

This  file  contains  one  procedure,  idc_choose_fifo,  which  determines  which  FIFO  to 
use.  ~  ~ 

Includes: 

"stdio.h" 

"sim_dfns.h" 

"fifo_dfn.h'’ 

"libidc_dfn.h" 

"libidc.h" 

"libmem_dfn.h" 


2. 1.4. 1.1. 1.1  idc_choose_fifo 

This  routine  determines  which  FIFO  to  use,  given  the  index  to  the  IDC_ARRAY  (id).  A 
pointer  to  the  appropriate  FIFO  segment  is  returned. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

id 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

idc  Dtr 

tJOintertolDC  ENTRY 

idc  dfn.h 

I 

int 

Standard 

mask 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

idc_ptr->fifo 

FIFO 

pointer  to  the  FIFO  to  be  used 

(FIFO  •)  FIFO ERROR 

FIFO 

null  pointer 

1  Calls  1 

Function 

Where  Described 

idc_get_numjdcs 

Section  2.1. 4.1. 3.1 

Section  2.1. 4.1 .4.1 

Section  2. 1.4.1 .5.1 

Table  2.1-406:  idc_choose_rifo  Information. 
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2. 1.4. 1.1. 2  i  error.c 

(7sunnet/release/src/libsrc/libidcA_error.c) 

This  file  contains  one  procedure,  libidc_error_report,  which  prints  an  error  report. 

Includes; 

"stdio.c" 

"idc.h" 

"idc_loc.h" 


2. 1.4. 1.1. 2.1  libidc_error_report 

This  procedure  prints  an  error  report. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

func 

pointer  to  char 

Standard 

saral 

char 

Standard 

nara2 

int 

Standard 

Table  2.1>407:  nbidc_error_report  Information. 
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2.1. 4.1. 1.3 


i^getact.c 

(./sminet/release/src/libsrc/libidc/i_getact.c) 


This  file  contains  one  function,  libidc_get_action,  which  retrums  the  IDC  actions. 

Includes: 

"stdio.h" 

"idc.h" 

"idcjoc.h" 


2. 1.4. 1.1. 3.1  libidc_get_action 

This  routine  translates  the  strings  in  the  parameter  file  to  the  appropriate  number  to  be  sent 
to  the  actions  file.  These  values  are  based  on  DDC  input  or  output  type.  The  actions  tile  is 
used  for  table  look-up  during  the  simulation.  It  is  unique  for  each  vehicle  that  is  simulated. 


1  Parameters  | 

1  Parameter 

Where  Typedef  Declared 

pointer  to  char 

Standard 

1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

ret 

int 

Standard 

i 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

ACTION.LEVEL 

int 

input  from  analog  switch 

ACTION_EDGE 

int 

input  from  pushbutton 

ACTION_BINARY 

int 

input  from  toggle  switch 

ACTION.METER 

int 

output  to  meter 

ACTION_DIGITAL 

int 

ACTION_SAD 

int 

output  to  situation  awareness 
display 

ACTION_SPECIAL 

int 

output  to  special  device 

ACTION_METER16 

int 

output  to  16  bit  meter 

ACTION_MTR16HI 

int 

output  to  top  8  bits  of  16  bit 
meter 

ACTION_MTR16LO 

int 

output  to  bottom  8  bits  of  16 
bit  meter 

ACTION_LEVEL16 

int 

input  from  16  bit  anaiog  switch 

ACTION_NONE 

int 

unrecognized  input/output 

Table  2.1<408:  libidc_get_action  Information. 
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2.1.4.1.1.4  i  getacts.c 

(.^mnet^elease/sicAibsrcAibidc  A_gctacts.c) 

This  file  com^s  one  procedure,  idc_get_actions,  which  returns  an  IDC  action. 

Includes: 

"stdiaih" 

"idc.te'" 

"idc_&x;.h" 


2.1.4.1.1.41.1  idc_get_actions 

This  routine  Returns  the  action  for  an  IDC  panel  specified  by  i.  This  is  a  utility  routine  and 
is  not  used  ducing  the  simulation.  The  return  value  is  a  character  rather  than  the  integer 
returned  by  iibidc_get_acts. 


1  Parameters  1 

1  Parameter 

Where  Tvoedef  Declared 

b _ _ _ 

int 

Standard 

1  Return  Values  1 

[Return  Valute 

Type 

Meaning 

char 

IDC  action  for  a  panel 

Table  2.1-409:  idc_get_actions  Information. 


2. 1.4. 1.1. 5  i^getdevice.c 

(7sTmnet/release/src/libsrc/libidc^_getdevice.c) 

This  file  contains  one  procedure,  idc_get_device_type,  which  returns  the  type  of  IDC 
device  that  is  'being  used 

Includes; 

"stdio;.h" 

"idc.b." 

"idcJiOc.h'' 


2.1.4.1.1.S.1  idc_get_device_ty  pe 

This  routine  iretums  a  code  which  designates  the  IDC  device  being  used.  This  is  a  utility 
routine  and  is  not  used  during  the  simulation. 


1  Return  Values  1 

Return  Valu.e 

Type 

Meaning 

libidcjdc_dev^e 

pointer  to  char 

the  IDC  device  type 

Table  2.1-410:  idc_get_device_type  Information. 
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2. 1.4. 1.1. 6  i  getnames.c 

(ysTnmet^lease/src/libsrc/libidc/i_getnanies,c) 

This  file  contains  one  procedure,  idc_get_naines,  which  returns  the  /th  element  of  the 
I/O  name  array. 

Includes: 

"stdio.h" 

"idc.h" 

"idcjoc.h" 


2. 1.4. 1.1. 6.1  idc_get_names 

This  routine  returns  a  pointer  to  the  string  name  in  the  I/O  name  array.  The  input  parameter 
1  is  an  index  into  the  IDC  table.  This  routine  is  a  utility  routine  and  is  not  used  during  the 
simulation. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

i 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

libidc_idc_namesli] 

pointer  to  char 

pointer  to  the  string  name 

Table  2.1<411:  idc_get_names  Information. 
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2. 1.4. 1.1.7  i^getoffset.c 

(./simnet/release/sic/libsrc/libidc^_getoffset.c) 


This  file  contains  one  procedure,  idc_get_offset,  which  returns  the  offset  in  shared 
memory.  ~ 


Includes: 

"stdio.h" 

"idc.h" 

"idcloc.h 


n 


2. 1.4.1. 1.7.1  idc_get_offset 

This  routine  returns  the  offset  in  shared  memory  of  the  current  station.  This  routine  is  a 
utility  routine  and  is  not  used  during  the  simulation. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

libidcJdc_offset 

int 

IDC  Offset  in  shared  memory  of 
current  station 

Table  2.1-412:  idc_get_offset  Information. 


2. 1.4. 1.1. 8  i^getport.c 

(./sTmnetAelease/src/libsrc/libidc  A_getportc) 


This  file  contains  one  procedure,  idc_get_port_name,  which  returns  a  pointer  to  the 
name  of  the  BDC  port.  ”  ” 

Includes: 

"stdio.h" 

"idc.h" 

"idcjoc.h" 


2. 1.4. 1.1. 8.1  idc_get_port_name 

This  routine  returns  a  pointer  to  the  IDC  port  name.  This  routine  is  a  utility  routine  and  is 
not  used  during  the  simulation. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

libidcjdcjjort 

pointer  to  char 

pointer  to  the  IDC  port  name 

Table  2.1-413:  idc_get_port_name  Information. 
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2. 1.4. 1.1. 9  i^getstat.c 

(ysTmnet/release/src/libsrc/libidc  A_getstat.c) 

This  file  contains  one  routine,  idc_get_station_description,  which  returns  the  IDC 
station  description.  ~  ~ 

Includes: 

"stdio.h" 

"idc.h" 

"idcjoc.h" 


2. 1.4. 1.1. 9.1  idc_get_station_description 

This  routine  returns  the  IDC  station  description.  This  routine  is  a  utility  routine  and  is  not 
used  during  the  simulation. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

libidcJdc_station 

char 

IDC  station  description 

Table  2.1-414:  idc_get_station_description  Information. 


2.1.4.1.1.10  Moc.c 

(./sTmnetAelease/src/libsrc/libidc  ^_loc.c) 

The  folio  vdng  arrays  and  variables  are  declared: 
Ubiti_idc_ibuf[80] 
libidc_idc_actions[MAX_IDC_ID] 
*libidc_idc_names[MAX_IDC_ID] 
libidc_idc_station[80] 
libidc_idcj)ort[80] 
libidc_idc_offset 
libidc_idc_device[80] 

Includes: 

"stdio.h" 

"idc.h" 
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2.1.4.1.1.11  i^open_port.c 

(./slmnet(^lease/src/libsrc/libidc/^_open_port.c) 

This  file  contains  one  procedure,  idc_open_port,  which  opens  an  IDC  port. 

Includes: 

"stdio.h" 

"signal.h"  Masscomponly 
"sys^octl.h"  Masscomponly 
"termio.h"  Masscomponly 
"idc.h" 

”sim_dfns.h" 

sim_types.h" 

"fifo_dfn.h" 

"fifo.h" 

"idcjoc.h" 

The  procedure  idc_open_port()  is  not  implemented  in  the  Butterfly.  It  is  implemented  in 

the  Masscomp.  ~ 


2.1.4.1.1.11.1  idc_open_port 

This  routine  opens  an  IDC  port.  The  file  descriptor  is  allocated.  The  port  is  then  set  up  for 
IDC  operation.  Port  status  is  obtained,  the  old  baud  rate  is  cleared  and  the  new  baud  rate  is 
set  at  4800  baud.  Raw  mode  is  set,  echo  is  turned  off,  and  characters  are  set  to  read. 
Updated  status  is  then  set. 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

port 

int 

Standard 

pname 

pointer  to  char 

Standard 

tio 

pointer  to  termio 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

port 

int 

port  file  descriptor 

1  Calls  1 

Function 

Where  Described 

idc  aet  port  name 

Section  2.1 .4.1. 1.8.1 

Table  2.1>415:  idc_open_port  Information. 
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2.1.4.1.1.12  i^perror.c 

(7slmnel/release/src/libsrc/libidc  ^_perror.c) 

This  file  contains  an  error  reporting  routine. 

Includes: 

"stdio.h" 

"idc.h" 

"idcjoc" 


2.1.4.1.1.12.1  Iibidc_per ror_report 

This  routine  is  an  error  reporting  routine. 


Parameters 


Parameters 


func 


naroz 


lETH! 
irs 
irs 


inter  tochar 


inter  to  char 


Where  Tvoedef  Declared 


Standard 


Standard 


Standard 


Internal  Variables 


Internal  Variable 


line 


Where  Typedef  Declared 


Standard 


Table  2.1>416:  libidc_perror_report  Information. 


2.1.4.1.1.13  i_^port_stk.c 

(./s'imnet/release/src/libsrc/libidc/i_port_stk.c) 

This  file  contains  a  routine  which  prints  an  error  message  when  ports  are  stuck. 

Includes: 

"stdio.h" 

"signal.h"  Masscomp  only 
"sysAoctLh"  Masscomp  only 
"termio.h"  Masscomp  only 
"idc.h" 

"sim_dfns.h" 

"sim_types.h" 

"fifo_dfn.h" 

"fifo.h" 


2.1.4.1.1.14.1  port_stuck 

This  procedure  prints  error  messages  when  a  port  is  stuck.  system("stty  -raw  echo") 
and  idc_get_port_name()  are  called.  This  routine  is  not  implemented  in  the  Butterfly. 
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2.1.4.1.1.15  i^^raw  16_set.c 

(yslmnet^lease/src/libsrc/libidc/i_raw_16_set.c) 

This  file  sends  a  two  byte  message  to  a  FIFO  port. 

Includes: 

"stdio.h" 

”signal.h"  Masscomponly 
"sysAoctl.h"  Masscomp  only 
"tenmo.h"  Masscomponly 
"idc.h" 

"libidc_dfn.h" 

"sim_dfns.h" 

"sim_types.h" 

"fifo_dfn.h" 

"fifo.h" 


idc_set_buf[8]  is  declared  as  a  static  character. 


2.1.4.1.1.15.1  idc_raw_16_set_cmd 

This  routine  sends  a  two  byte  message  to  a  FIFO  port,  given  the  index  to  the  IDC  table. 

The  parameters  are  defined  as  follows: 

fifo  -  the  FIFO  port  to  be  accessed. 

id  -  index  into  IDC  table. 

val  -  two  byte  message  to  be  sent. 

This  routine  is  a  utilities  routine  and  is  not  used  during  the  simulation. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

fifo 

pointer  to  FIFO 

fifo  dfn.h 

id 

int 

Standard 

val 

short  int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

ret 

int 

Standard 

i 

int 

Standard 

Calls 

Function 

Where  Described 

fifo_enqueue 

Section  2.6.8.2.1 

Table  2.1-417:  idc_raw_16_set_cmd  Information. 
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2.1.4.1.1.16  i^raw  16_st2.c 

(./sunnet^lease/src/libstc/libidc  /i_raw_l  6_st2.c) 

This  file  sends  a  four  byte  message  to  a  FIFO  port. 

Includes: 

"stdio.h" 

"signal.h''  Masscomp  only 
"sys^octl.h"  Masscomp  only 
"termio.h"  Masscomp  only 
"idc.h" 

"libidc_dfn.h" 

"sim_dfns.h" 

"sim_types.h" 

"fifo_dfn.h" 

"fifo.h" 

idc_set2_buf[8]  is  declared  as  a  static  character. 


2.1.4.1.1.16.1  idc_raw_16_set2_cmd 

This  routine  sends  a  four  byte  message  to  the  specified  FIFO  port,  given  an  index  into  the 
IDC  table.  The  parameters  are  defin^  as  follows: 

-  the  FIFO  port  to  be  accessed. 

-  index  into  IDC  table. 

-  first  two  bytes  of  the  four  byte  message  to  be  sent. 

-  last  two  bytes  of  the  four  byte  message  to  be  sent. 


This  routine  is  a  utilities  routine  and  is  not  used  during  the  simulation. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

fifo 

pointer  to  FIFO 

fifo  dfn.h 

id 

int 

Standard 

vai1 

short  int 

Standard 

vai2 

short  int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

ret 

int 

Standard 

i 

int 

Standard 

I  Calls  I 

Function 

Where  Described 

fifo  enqueue 

Section  2.6.8.2.1 

fifo 

id 

vail 

val2 


Table  2.1>418:  idc  raw  16  set2  cmd  Information. 
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2.1.4.1.1.17  i  raw  set.c 

(./sininet^lease/src/libsrc/libidc/Lraw_set.c) 

This  file  sends  a  one  byte  message  to  a  FIFO  port 
Includes: 

"stdio.h" 

"signal.h"  Masscomponly 
"sysAoctl.h"  Masscomp  only 
"termio.h"  Masscomponly 
"idc.h" 

"Ubidc_dfn.h" 

"sim_dfns.h" 

"sim_types.h" 

"fifo_dfn.h" 

"fifo.h" 

idc_set_buf[8]  is  declared  as  a  static  character. 


2.1.4.1.1.17.1  idc_raw_set_cmd 

This  routine  sends  a  one  byte  message  to  the  specified  FIFO  port,  given  an  index  into  the 
IDC  table.  The  parameters  are  defined  as  follows: 
fifo  -  the  FIFO  port  to  be  accessed. 

id  -  index  into  IDC  table,  representing  a  particular  IDC  panel. 

val  -  one  byte  message  to  be  sent. 

This  routine  is  a  utilities  routine  and  is  not  used  during  the  simulation. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

fifo 

pointer  to  FiFO 

fifo  dfn.h 

id 

int 

Standard 

vai 

short  int 

Standard 

1  Calls  1 

Function 

Where  Described 

fifo  . enqueue 

Section  2.6.8.2.1 

Table  2.1>419:  idc  raw  set  cmd  Information. 
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2.1.4.1.1.18  i  readbody.c 

(ysunneVrelease/src/libsrc/libidc/i_readbody.c) 

■Diis  file  contains  a  routine  which  reads  the  IDC  parameter  file  body. 
Includes: 


"stdio.h" 

"idc.h" 

"idc_loc.h" 


2.1.4.1.1.18.1  ]ibidc_read_idc_paraineter_body 

This  routine  reads  the  IDC  parameter  file  body,  name  is  a  pointer  to  the  file  name.  This 
routine  is  a  utility  routine  and  is  not  used  during  the  simulation. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

to 

pointer  to  FILE 

Standard 

name 

pointer  to  char 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

id 

int 

Standard 

tvoelSOl 

char 

Standard 

idnamefSOI 

char 

Standard 

action 

int 

Standard 

libidc  strsave 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

libidc  strsave 

Section  2.1 .4.1. 1.8.8 

libidc  error  report 

Section  2.1 .4.1. 1.8.8 

libidc  aet  actions 

Section  2.1 .4.1. 1.8.8 

Table  2.1-420: 


libidc_read_idc_parameter_body  Information. 
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2.1.4.1.1.19  i^readfilejc 

(./sTmnet/rcleajse/src/libsrc/libidc/i_readfile.c) 


This  file  contains  a  routine  wtuch  reads  an  IDC  parameter  file. 
Includes; 


"stdio.h" 

"idc.h" 

"idcJoc.h" 

DEBUG  is  defined  as  FALSE. 


2.1.4.1.1.19.1  read!_idc_parameter_file 

This  routine  reads  the  IDC  parameter  file,  name  is  a  pointer  to  the  name  of  the  parameter 
file.  The  parameter  file  maps  logical  names  to  shared  memory  offsets.  This  routine  is  a 
utility  routine  and  is  not  used  during  the  simulation. 


1  Parameters  I 

Parameter 

Type 

1  Where  Typedef 

Declared  1 

name 

pointer  to  char 

Standard  I 

1  Internal  Variables  I 

Internal  Variables 

Where  Tvpedef 

Declared  1 

fp 

oointer  to  FILE 

Standard 

:  int 

Standard 

1  Calls  1 

Function 

1  Where  Described 

libido  perror  report 

1  Section  2.1.4.1.1.12.1 

Iibidc_read_idcj3arameter_ 

header 

1  Section  2.1.4.1.1.20.1 

Iibidc_read_idcj3arameter_ 

body 

Section  2.1.4.1.1.18.1 

Table  2.1-421:  read_ldc_parameter_file  Information. 
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2.1.4.1.1.20  i^readhead.c 

(ysTninet/release/src/libsrc/libidc/i_readhead.c) 


This  file  contains  a  routine  which  reads  the  IDC  parameter  file  header. 
Includes: 


"stdio.h" 

"idc.h" 

"idcJoc.h" 

DEBUG  is  defined  as  FALSE. 


2.1.4.1.1.20.1  libidc_read_idc_paraineter_header 

This  routine  reads  the  IDC  parameter  file  header,  name  is  a  pointer  to  the  file  name.  This 
routine  is  a  utility  routine  and  is  not  used  during  the  simulation. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

to 

pointer  to  FILE 

Standard 

name 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

libidc  error  report 

Section  2.1. 4.1. 1.2.1 

Table  2.1<422:  libidc_read_idc_parameter_header  Information. 
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2.1.4.1.1.21 

(yamns^jtelease/sic/libsTc/libidc  ^_reset.c) 
This  file  contains  anDfnttine  which  resets  the  FIFO  port. 
Includes: 

"stdio.h" 

”signal.h"  Masscomp  only 
"sysAoctl.lt"  IM^scomponly 
"termio.h"  Maasscomp  only 
"idc.h" 

"Ubidc.dfiLli" 

"sim_dfns.h" 

"sim_types.il" 

"fifo_dfn.h" 

"fifo.h" 

idc_reset_birf[8]  is  declared  as  a  static  character. 


2.1.4.1.1.21.1  idc_reset_cmd 

This  routine  resets  the  FIFO  buffer  designated  hyfifo.  The  reset  conunand  is  interpreted 
by  the  IDC  hardware. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

fifo 

pointer  to  FIFO 

fifo  dfn.h 

1  Calls  1 

Function 

Where  Described 

fifo  enqueue 

Section  2.6.8.2.1 

Table  2.1-423:  idc  reset  cmd  Information. 
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2.1.4.1.1.22  i^strsave.c 

(ysmmeVrcleaseysrc/libsrc/libidc  /Lstrsave.c) 

This  file  contains  a  routine  which  saves  a  string. 

Includes: 


"stdio.h" 

"idc.h" 

"idc_loc.h" 


2.1.4.1.1.22.1  libidc_strsave 

A  string  is  copied  and  saved.  This  routine  then  returns  a  pointer  to  that  string.  This  routine 
is  a  utility  routine  and  is  not  used  during  the  simulation. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

f 

pointer  to  char 

Standard 

Internal  Variables 

Internal  Variable 

Where  Tvoedef  Declared 

t 

pointer  to  char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

t 

pointer  to  char 

pointer  to  a  string  of  interest 

1  Calls  1 

Function 

Where  Described 

libidc  perror  report 

Section  2.1.4.1.1.12.1 

Table  2.1*424:  libidc^strsave  Information. 


2.1.4.1.1.23  idc_loc.h 

(./simnetAelease/src/libsrc/libidc/idc_loc.h) 

This  file  defines  constants  and  declares  external  variables  and  procedures  which  are  used 
within  libidc. 
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2.1.4.1.1.24  innt.c 

(ysionnet/release/src/libsrc/libidc  /mite) 

This  file  contains  nsuttines  which  initiallize  the  IDCs  at  the  start  of  a  simulation. 

Includes: 

*'stdio.h" 

"fontLh" 

"sim_dfna.lt'" 

"fifo_dfn.lt:' 

"fifo.h" 

"Ubidc_dfn.&" 

"Ubidc.h" 

"libmem_<ffiii.h" 

The  following  extennal  variables  are  declared: 
reset_idc_insg  [IDC_RESET_SIZE] 
set_idc_msg  |1DC_SET_SIZE] 
set_16_idc_Bnsg  [IDC_SET_16_SIZE] 
set2_16_idc_msg  [IDC_SET2_16_SI2E] 


2.1.4.1.1.24.1  idejnit 

This  routine  initially  the  BDC  shared  memory.  The  IDC_ARRAY  of  IDC_ENTRIES  is 
initialized.  The  FIFO  segment  of  shared  memory  is  initialized.  The  IDC  ports  are  reset 
Vehicle-specific  inMalizations  are  accomplished  via  idc_veh_spec_lnltO  so  that  the 
appropriate  lights  ansi  meters  are  set  for  startup. 


Calls 

Function 

Where  Described 

idc_aiTayJnit 

Section  2.1. 4.1 .3.2 

Section  2.1. 4.1. 4.2 

Section  2.1 .4.1 .5.2 

idc  fifo  inh 

Section  2.1.4.1.1.24.2 

idc  reset 

Section  2.1.4.1.1.24.4 

idc_veh_specjnit 

Section  2. 1.4. 1.3.4 

Section  2.1. 4.1 .4.4 

Section  2.1. 4.1 .5.4 

Table  2.1-425:  idc  init  Information. 
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2.1.4.1.1.24.2  idcjifojnit 

This  routine  searches  through  the  IDC_ENTRIES  and  initializes  the  FIFO  portion  of  the 
shared  memory. 


1  Internal  Variables  | 

Internal  Variable 

Tvne 

Where  Tvpedef  Declared 

idc  Dtr 

pointer  to  IDC  ENTRY 

libidc  dfn.h 

I 

int 

Standard 

Calls 

Function 

Where  Described 

idc_get_numjdcs 

Section  2.1 .3.1 .3.1 

Section  2.1 .3.1. 4.1 

Section  2.1. 3.1 .5.1 

fifo  init 

Section  2.6.8.5.1 

Table  2.1-426:  idc  fifo  init  Information. 


2.1.4.1.1.24.3  idc_fifo_uninit 

This  routine  uninitializes  the  FIFO  portion  of  the  shared  memory. 


1  Internal  Variables  I 

Internal  Variable 

Where  Tvpedef  Declared 

idc  ptr 

pointertolDC  ENTRY 

libidc  dfn.h 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

idc_get_numjdcs 

Section  2. 1.3.1 .3.1 

Section  2.1. 3.1. 4.1 

Section  2. 1.3.1. 5.1 

fifo  uninit 

Section  2.6.8.3.2 

Table  2.1-427:  idc  fifo  uninit  Information. 


2.1.4.1.1.24.4  idc  reset 


This  routine  resets  the  IDC  inputs  and  outputs. 


1  Calls  1 

Function 

Where  Described 

idc  reset  input 

Section  2.1.4.1.1.24.5 

idc  reset  output 

Section  2.1.4.1.1.24.6 

Table  2.1-428:  idc  reset  Information. 
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2.1.4.1.1.24.5  idc_reset_input 

This  routine  clears  the  IDC  portion  of  the  shared  memory. 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Tvpedef  Declared 

1 

int 

Standard 

Calls 

Function 

Where  Described 

idc  aet  idc  share  size 

Section  2. 1.4.1 

Table  2.1*429:  idc_reset_input  Information. 


2.1.4.1.1.24.6  idc_reset_output 

This  routine  sends  a  reset  command  to  the  IDCs. 


1  Internal  Variables  | 

Internal  Variable 

Where  Typedef  Declared 

idc  Dtr 

pointer  to  IDC  ENTRY 

libidc  dfn.h 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

idc_get_numjdcs 

Section  2.1 .3.1. 3.1 

Section  2.1. 3.1 .4.1 

Section  2. 1.3.1 .5.1 

fifo  uninit 

Section  2.6.8.3.2 

Table  2.1-430:  idc_reset_output  Information. 
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2.1.4.1.1.25  op_16  set.c 

(ysinmet^lease/src/libsrc/libidc  /op_l  6_seLc) 

This  file  sends  a  two  byte  message  to  output. 

Includes: 


"stdio" 

"sim_dfns.h" 

"fifo_dfn.h" 

"fifo.h: 

"libidc_dfn.h" 

"Ubidc.h" 

"libmem_dfa.h" 


2.1.4.1.1.25.1  idc_output_16_set 

This  routine  sends  a  two  byte  message  to  a  serial  pmt  and  copies  the  data  to  shared 
memory.  The  parameters  are  defined  as  follows: 
id  -  an  index  into  the  IDC  table. 

val  -  the  data  to  be  sent. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

id 

int 

Standard 

val 

short  int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

fifo 

pointer  to  FIFO 

fifo  dfn.h 

1  Calls  1 

Function 

Where  Described 

idc  choose  fifo 

Section  2.1. 4.1. 1.1.1 

fifo  enoueue 

Section  2.6.8.2.1 

Table  2.1'431:  idc_output_16_set  Information. 
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2.1.4.1.1.26  op_16  set2.c 

(7sinmet^lease/src/libsrc/libidc  /op_l  8_set2.c) 


This  file  sends  a  four  byte  message  to  output. 


Includes: 


"stdio" 

"sim  dfns.h" 

"fifo_dfn.h" 

"fifo.h" 

"Ubidc_dfn.h" 

”libidc.h" 

"libn[iem_dfh.h" 


2.1.4.1.1.26.1  idc_output_16_set2 

This  routine  sends  a  four  byte  message  to  a  serial  port  and  copies  the  data  to  shared 

memory.  The  parameters  are  defined  as  follows; 

id  -  an  index  into  the  IDC  table. 

vail  -  the  first  two  bytes  of  the  data  to  be  sent. 

val2  -  the  last  two  bytes  of  the  data  to  be  sent. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

id 

int 

Standard 

van 

short  int 

Standard 

val2 

short  int 

Standard 

Internal  Variables 

1  Internal  Variable 

Where  Typedef  Declared 

Ififo 

pointer  to  FIFO 

fifo  dfn.h 

1  Calls  1 

Function 

Where  Described 

idc  choose,  fifo 

Section  2.I.4.1. 1.1.1 

fifo  enoueue 

Section  2.6.8.2.1 

Table  2.1>432:  idc_output_16_set2  Information. 
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2.1.4.1.1.27  op_rest.c 

(ysiinhetAclease/src/libsrc/libidc/op_rest.c) 

This  file  contains  one  procedure,  idc_output_restore. 
Includes: 


"stdio.h" 

"sim_dfns.h" 

"fifo_dfn.h" 

Tifo.h" 

'*Ubidc_dfn.h" 

"Ubidc.h" 

"libmem_dfn.h" 


2.1.4.1.1.27.1  idc_output_restore 

This  routine  reads  the  value  in  shared  memory  and  sends  it  to  the  serial  port  id  designates 
the  location  in  shared  memory  that  is  of  interest 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

id 

int 

Standard 

1  Internal  Variables  I 

Internal  Variable 

Where  Tvpedef  Declared 

fifo 

pointer  to  FIFO 

fifo  dfn.h 

1  Calls  1 

Function 

Where  Described 

fifo._engueue 

Section  2.6.8.2.1 

Table  2.1-433:  idc_output_restore  Information. 
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2.1.4.1.1.28  op_rest  c.c 

(ysimhet^lease/src/libsrc/libidc  /op_rest_c.c) 

This  file  contains  one  procedure,  idc_output_restore_cond. 
Includes: 


•'stdio.h" 

"sim_dfns.h" 

"fifo_dfn.h" 

"fifo.h" 

"Ubidc_dfn.h" 

"Ubidc.h" 

”libmem_dfh.h" 


2.1.4.1.1.28.1  idc_output_restore_coii  d 

This  routine  conditionally  calls  the  output  restore  routine.  The  parameters  are  defined  as 
follows: 

id  -  designates  the  location  in  shared  memory. 

cond  -  specifies  the  condition  under  which  the  output  restore  routine  should  be 

called. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

(d 

int 

Standard 

val 

char 

Standard 

1  Calls  1 

Function 

Where  Described 

idc  output  restore 

Section  2.1.4.1.1.27.1 

Table  2.1-434:  idc_output_restore_cond  Information. 
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2.1.4.1.1.29  op_set.c 

(ysinihet/release/src/Iibsrc/libidc  /op_setc) 


Includes: 

"stdio.h" 

"sim_dfns.h" 

Tifo_<ifn.h" 

"fifo.h" 

’’Ubidc_dfn.h" 

"libidc.h" 

"libmem_dfii.h" 


2.1.4.1.1.29.1  idc_output_set_ns_cond 

This  routine  determines  which  FIFO  port  to  use,  stores  the  data  as  well  as  the  address  of 
the  data  in  shared  memory,  and  queues  the  data  to  the  appropriate  FIFO  port.  The 
parameters  are  defined  as  follows: 
id  -  the  address  in  shared  memory, 

val  -  the  data  to  be  sent 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

id 

int 

Standard 

val 

char 

Standard 

Internal  Variables 

[Internal  Variables 

Where  Tvoedef  Declared 

Ififo 

pointer  to  FIFO 

fifo  dfn.h 

Calls 

Function 

Where  Described 

idc  choose  fifo 

Section  2.1.4.1.1.1.1 

fifo  _  enqueue 

Section  2.6.8.2.1 

Table  2.1-435:  ldc_output_set_ns_cond  Information. 
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2.1.4.1.1.30  op_set_c.c 

(ysimnet/rclease/src/libsrc/libidc/op_set_c.c) 


This  file  contains  one  procedure,  idc_output_set_cond,  which  sets  output  under  certain 
conditions. 


Includes; 

"stdio.h" 

"sim_dfns.h" 

"fifo_dfn.h" 

"fifo.h" 

”Ubidc_dfn.h" 

•*Ubidc.h" 

"libnoem_dfh.h" 


2.1 .4. 1 . 1.30. 1  idc_output_set_cond 

This  routine  sets  output  under  certain  conditions.  The  parameters  are  defined  as  follows: 
cond  -  condition  under  which  to  set  outputs. 

id  -  index  into  IDC  array. 

val  -  the  data  to  be  sent 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

cond 

int 

Standard 

id 

ini 

Standard 

vai 

char 

Standard 

Calls 

Function 

Where  Described 

idc  ODutput  set 

Section  2.1.4 

Table  2.1-436:  idc_output_set_cond  Information. 
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2.1.4.1.1.31  op_set_ns.c 

(7sirmietAilease/src/libsrc/libidc/op_set_ns.c) 

This  file  contains  one  procedure,  idc_output  set_ns_cond,  which  sends  an  output 
request  to  an  appropriate  IDC  with  no  update  of  shared  memory. 

Includes: 

"stdio.h" 

"sim_dfns.h" 

"fifo_dfn.h" 

"fifo.h" 

"Ubidc_dfn.h" 

"Ubidc.h" 

"libmem_dfii.h" 


2.1.4.1.1.31.1  idc_output_set_ns_cond 

This  routine  sends  an  output  request  to  an  appropriate  IDC  with  no  update  of  shared 
memory.  The  parameters  are  defined  as  follows: 
id  -  index  into  IDC  array. 

val  -  the  data  to  be  sent 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

id 

int 

Standard 

val 

char 

Standard 

1  Internal  Variables  I 

1  Internal  Variables 

Where  Tvoedef  Declared 

Ififo 

pointer  to  FIFO 

fifo  dfn.h 

Calls 

Function 

Where  Described 

fifo  enqueue 

Section  2.6.8.2.1 

Table  2.1-437:  idc_output_set_ns_cond  Information. 
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2.1.4.1.1.32  op_set_ns_c.c 

(ysiinhet/releaie/sic/libsrc/libidc/op_set_ns_c.c) 

This  file  contains  one  procedure,  idc  output_set_ns_cond,  which  conditionally  sends 
an  ou^ut  request  to  an  appropriate  IDC  with  no  update  of  shared  memory. 

Includes: 

"stdio.h" 

"sim_dfns.h" 

"fifo_dfn.h" 

"fifo.h" 

"libidc_dfn.h" 

"Ubidc.h" 

"libmem_dfii.h" 


2.1.4.1.1.32.1  idc_output_set_ns_cond 

This  routine  conditionally  sends  an  output  request  to  an  appropriate  IDC  with  no  update  of 

shared  memory.  The  parameters  are  defined  as  follows: 

cond  -  designates  the  condition  under  which  to  send  an  output  request. 

id  -  index  into  die  IDC  array. 

val  •  the  data  to  be  sent. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

cond 

hit 

Standard 

id 

int 

Standard 

val 

char 

Standard 

1  Calls  1 

Function 

Where  Described 

idc  oputput  set  ns 

Section  2.1.4.1.31.1 

Table  2.1-438:  idc_output_set_ns_cond  Information. 
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2.1.4.1.2  libpots 

(./simnet/release/src/libsrc/libpots  [libpots] ) 

Potentiometers  are  used  during  the  simulation  to  transmit  aanalog  sisals  from  the  controls. 
The  potentiometer  returns  an  analog  voltage  (between  0  -  ff  hex)  which  is  converted  to  a 
digital  value.  The  simulation  requires  these  values  to  be  translated  to  real  numbers  between 
-1.0  and  1.0  (or  0  and  1.0).  The  potentiometers  also  .must  be  calibrated  so  that  their  full 
range  maps  to  the  appropriate  values.  This  functionality  is  provided  by  this  CSU. 


2. 1.4. 1.2.1  p^clamp.c 

(./simnet/release/src/libsrc/libpots/p_clamp.c) 

This  file  contains  a  routine  which  crops  a  value. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_macros.h" 

"libpots.h" 


2. 1.4. 1.2. 1.1  pots_^clamp_pot_bet  ween 

This  routine  crops  the  input  value  pot.  If  pot  is  below  the  lower  limit,  the  lower  limit  is 
returned.  If  it  is  above  the  upper  limit,  the  upper  limit  is  returned,  vail  and  va/2  define  the 
required  range.  If  pot  falls  within  the  range,  it  is  returned. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

pot 

int 

Standard 

van 

int 

Standard 

val2 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

mini 

int 

Standard 

maxi 

int 

Standard 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

pot 

int 

new  value  of  the 
potentiometer 

Table  2.1-440:  pots_clamp_pot_between  Information. 
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2. 1.4. 1.2. 2  p_lcr.c 

(VsSimet/release/src/libsrc/libpots/pJcr.c) 

This  file  contains  a  routine  which  clamps  a  pot  value  to  the  left,  center,  or  right,  depending 
on  its  value. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_<ifns.h" 

"sim_macros.h" 

"libpots.h" 


2. 1.4. 1.2.2. 1  pots_scale_lcr 

The  value  pot  is  first  clamped  to  the  left  or  right.  A  dead  zone  of  size  tolerance  is  created  in 
each  direction  ftom  the  center  position  (center).  The  appropriate  real  value  is  then  assigned 
between  -1.0  and  1.0. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

pot 

int 

Standard 

left 

int 

Standard 

center 

int 

Standard 

riaht 

int 

Standard 

tolerance 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

new  left 

int 

Standard 

new  riaht 

int 

Standard 

retval 

REAL 

Sim  types. h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

retval 

REAL 

calibrated  pot  value 

1  Calls  1 

runctlon 

Where  Described 

pots  clamp  pots  between 

Section  2. 1.4. 1.2, 1.1 

Table  2.1-441;  pots_scale_lcr  Information. 
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2. 1.4. 1.2. 3  p^Ir_both.c 

(./s{thnet/release/srcAibsrc/libpots/p_lr_both.c) 

This  file  contains  a  routine  which  scales  a  potentiometer  value  to  between  -1.0  and  1.0. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"Ubpots.h" 


2. 1.4. 1.2. 3.1  pots_scaIe_lr_both 

This  routine  scales  the  potentiometer  value  to  between  -1.0  and  1.0.  pot  is  the 
potentiometer  value,  and  left  and  right  define  the  range. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

pot 

int 

Standard 

left 

int 

Standard 

riaht 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

retval 

REAL 

Sim  tvpes.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

retval 

REAL 

calibrated  value  of 
potentiometer  value 

1  Calls  1 

Function 

Where  Described 

pots  clamp  pot  between 

Section  2.1. 4.1. 2.1.1 

Table  2.1-442:  pots_scale_lr_both  Information. 
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2. 1.4. 1.2.4 


p_lr_pos.c 

(./sininet/rclease/src/libsrc/libpots/p_lr_pos.c) 


This  file  contains  a  routine  which  scales  a  potentiometer  value  to  between  0.0  and  1.0. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_(tfns.h" 

"sim_macros.h" 

"Ubpots.h" 


2. 1.4. 1.2. 4.1  pots_scale_Ir_pos 

This  routine  scales  the  potentiometer  value  to  between  0.0  and  1 .0.  pot  is  the  potentiometer 
value,  and  and  right  define  the  range. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

Dot 

int 

Standard 

left 

int 

Standard 

riaht 

int 

Standard 

1  Internal  Variables  I 

[Internal  Variable 

wipnmmmmmmm 

Where  Tvoedef  Declared  I 

1  retval 

REAL 

Sim  tvpes.h  1 

1  Return  Values  1 

Return  Value 

Meaning 

retval 

REAL 

calibrated  vaiue 

1  Calls  1 

Function 

Where  Described 

pots  clamp  pot  between 

Section  2. 1.4.1. 2.1.1 

Table  2.1>443:  pots_scaieJr_pos  Information. 
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2. 1.4.1. 2. 5  p^th'ree.c 

(ysininet/reIease/sic/libsrc/libpots/p_three.c) 

This  ffle  contains  a  routine  which  verifies  that  three  potentiometer  values  are  valid. 

Inclucfes: 

”!stdio.h" 

‘'aim_types.h" 

’*?sim_dfns.h" 

“■sim_macros.h" 

’Tibpots.h" 


2. 1.4.1. 2. 5.1  pots_check_three 

This  routine  verifies  that  three  potentiometer  values  are  valid.  It  determines  if  the  middle 
value  is  itn  fact  the  middle  value.  If  it  is,  the  routine  returns  TRUE.  If  it  is  not,  it  returns 
FALSE  and  prints  the  line  number  (line)  in  the  calibration  file  where  this  error  occurred. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

line 

int 

Standard 

first 

int 

Standard 

second 

int 

Standard 

third 

int 

Standard 

Return  Values 

Return  Value 

Meanina 

TRUE 

int 

valid  pot  values 

FALSE 

int 

invalid  do\  values 

Table  2.1-444: 


pots_check_three  Information. 
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2. 1.4. 1.2. 6  p^two.c 

(./simnet/release/src/libsrcAibpots^_two.c) 

This  file  contains  a  routine  which  determines  if  two  potentiometer  values  are  valid. 

Includes: 

"stdio.h" 

"sim_types.h" 

"sim_{&hs.h" 

"sim_macros.h" 

"Ubpots.h" 


2. 1.4. 1.2.6. 1  pots_check_two 

This  routine  determines  if  two  potentiometer  values  are  valid.  If  the  two  values  (first  and 
second)  are  not  equal,  the  routine  returns  TRUE.  If  the  two  values  are  equal,  the  routine 
returns  FALSE  and  prints  the  line  number  (line)  in  the  calibration  file  where  the  error 
occurred. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

line 

int 

Standard 

first 

int 

Standard 

second 

int 

Standard 

Table  2.1-445:  pots_check_two  Information. 


2. 1.4. 1.2. 7  libpots.h 

(./simnet/release/src/libsrc/libpots/libpots.h) 

This  file  declares  the  following  procedures  for  use  outside  of  libpots. 

pots_clamp_pot_between() 

pots”scaIe_lcr()~ 

pots~scale~lr_both() 

pots~scaIeJr”pos() 

pots”check_three() 

pots~check_two() 
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2>].4.1.3  iiil_idc.c 

(ysimnet/release/src/vehicle/ml/src/ml_idc.c  [mljdc.c]) 
This  CSU  contains  routines  which  initialize  the  IDCs  for  the  Ml  simulator. 


Includes; 

"stdio.h" 

”sim_dfns.h" 

•Tifo_dfn.h" 

"fifo.h" 

"Ubidc.h" 

"libidc_dfn.h" 

"Ubmem.h" 

"Ubmem_dfh.h" 

''ml_mem_dfn.h" 

"ml_driv_pn.h" 

"ml_turr_pn.h" 

"ml  idc.h" 


Defined: 

NUM_IDCS 

Dedaaed: 

idc_array[NUM_IDCS] 

2.1»4.1.3.1  idc_get_num_idcs 

This  routine  returns  the  number  of  IDCs  that  are  used. 


1  Return  Values  I 

RetuH-n  Value 

Type 

Meaning 

NUMJDCS 

int 

the  number  of  IDCs  used 

Table  2.1-446;  idc_get_num_idcs  Information. 
2.1. '4. 1.3.2  idc_array_init 
This  routine  initializes  the  IDC  array. 

2. 1.4. 1.3. 3  idc_invert_outputs 
This  routine  sets  the  outputs. 


1  Calls  1 

Function 

Where  Described 

idc  output  set 

Section  2.1.4 

lable  2,1-447:  idc_invert_outputs  Information. 


2. 1.4. 1.3.4  idc_veh_spec_init 

This  routine  is  stubbed  out  but  contains  no  functionality. 
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2. 1.4. 1.3.4  idc_veh_spec_init 

This  routine  initializes  the  reticles  associated  with  the  M2  simulator. 


1  Calls  1 

Function 

Where  Described 

idc  output  set 

Section  2.1.4 

Table  2.1-450:  idc_veh_spec_init  Information. 


2 . 1 . 4. 1 . 3 .5  idc_set_reticle_init_val 

This  routine  sets  the  initial  values  for  the  reticles.  The  values  are  set  to  mm. 


I  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

num 

int 

Standard 

Table  2.1-451: 


idc  set  reticle  init  val  Information. 
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2. 1.4. 1.5  katojdc.c 

(./siinnet/release/src/vehicle/kato/src/kato_idc.c  [kato_idc.c]) 

This  CSU  contains  the  routines  which  initialize  the  IDCs  for  the  Stealth. 

Includes: 

"stdio.h" 

"siin_dfns.h" 

'’fifo_dfn.h" 

"fifo.h" 

"libidc.h" 

"Ubidc_dfn.h" 

"Ubmem.h’‘ 

"libinem_dfh.h" 

"kato_tneni_dfn.h" 

"kato_hard.h"  (for  use  with  spaceball) 

"kato_soft.h" 


Defined: 

NUM_IDCS 

Declared: 

idc_array[NUM_IDCS] 


2. 1.4. 1.5.1  idc_get_num_idcs 

This  routine  returns  the  number  of  IDCs  which  are  used. 


1  Return  Values  1 

Return  Value 

Meaning 

NUMJDCS 

int 

the  number  of  IDCs  used 

Table  2,1-452;  idc_get_num_ldcs  Information. 


2. 1.4. 1.5.2  idc_array_lnit 

This  routine  initializes  the  IDC  array. 


2. 1.4. 1.5. 3  idc_veh_spec_init 

This  routine  is  stubbed  out  but  contains  no  functionality. 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2. 1.4.2  High  Performance  Analog  Interface 

The  High  Perfonnance  Analog  Interface  CSC  implements  the  interface  to  the  high 
performance  analog  interface.  This  additional  input  device  was  required  because  the  8  bit 
analog  to  digital  converter  provided  on  the  IDC  boards  did  not  have  sirfficient  resolution  for 
some  of  the  potentiometers  on  the  Ml  simulation.  The  only  CSU  required  is  libdtad. 


2.1. 4.2.1  libdtad 

(7simnetAelease/src/libsrc/libdtad  [libdtad]) 

Libdtad  provides  support  for  the  data  translation  card. 

2. 1.4. 2. 1.1  ain.c 

(./simnetAelease/src/libsrc/libdtad/ain.c) 

Includes  "dtad_loc.h" 

2. 1.4. 2. 1.1.1  ain 

This  routine  returns  the  analog  input  value  given  the  channel  number,  channel  represents 
the  analog  input  channel  (0-7)  on  the  Data  Translation  card.  These  channels  are  mapped  to 
potentiometers  on  the  card.  If  access  to  the  card  is  not  enabled,  this  routine  returns  a  value 
of  0  (the  lowest  value  of  the  input  range).  If  the  polling  loop  times  out,  -1  is  returned. 


Note  that  since  the  AD  card's  busy  bit  is  not  asserted  quickly  enough  before  polling  starts, 
a  delay  is  necessary  to  prevent  reading  the  AD  before  its  conversion  has  started. 


Parameters  1 

Parameter 

Where  Typedef  Declared 

channel 

int 

Standard 

Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

int 

Standard 

temp 

int 

Standard 

Return  Values  1 

Return  Value 

Type 

Meanina 

0 

int 

lowest  value  of  analog  input; 
access  is  not  enabled 

-1 

int 

the  card  is  bad 

Dtad_read() 

int 

analog  input  value  of  0-4095; 
linearly  related  to  the  analog 
input  voltage 

1  Calls  1 

Function 

Where  Described 

Dtad  start 

dtad.h 

Dtad  pull 

dtad.h 

Dtad  read 

dtad.h 

Table  2.1>453:  ain  Information. 
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2. 1.4. 2. 1.2  attatch.c 

(ysimnetAelease/src/libsrc/libdtad/attatch.c) 


Includes: 

"dtad_loc.h" 


2. 1.4.2. 1.2.1  dtad_attach 

This  routine  attaches  the  Dtad  device  to  the  process.  The  hardware  is  mapped  into  the 
host's  address  space  so  it  can  be  accessed.  The  routine  returns  0  if  it  is  sucessful  and  -1  if 
it  fails. 


1  Internal  Variables  I 

Variable 

Where  Tvpedef  Declared 

sbrkQ 

pointer  to  char 
(MASSCOMP  onlv) 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

0 

int 

procedure  successful 

-1 

int 

procedure  failed 

I  Calls  I 

I  Function 

Where  Described 

iiif.i  'Jiiii  •]  i-u  iMiii-i' W'fi  I H  il 

Standard  Butterfly  function 

Standard  Masscomo  function 

Table  2.1-454:  dtad  attach  Information. 
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2. 1.4.2. 1.3  cur_ininusl2.c 

(./simnel/release/src/libsrc/libdtad/cur_minusl2.c) 


Includes: 

"dtadjoc.h" 

2. 1.4.2. 1.3.1  current_ininusl2 

This  routine  reads  the  -12  volt  power  supply  and  returns  the  current  voltage  (which  maps  to 
the  value  of  a  specified  potentiometer).  The  value  is  rounded  to  the  nearest  tenth  of  a  volt 
because  of  limited  measurement  accuracy. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

voltage 

register  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

voltage/10.0 

float 

-12  volt  power  supply  voltage 

I  Calls  I 

Function 

Where  Described 

ain 

Section  2.1. 4.2.1. 1.1 

Table  2.1-455:  current_inlnusl2  Information. 

2. 1.4.2. 1.4  cur_plusl2.c 

(./simnet/release/src/libsrcAibdtad/cur_plus  1 2.c) 


Includes: 

"dtadjoc.h" 

2. 1.4.2. 1.4.1  current_plusl2 

This  routine  reads  the  +12  volt  power  supply  and  returns  the  current  voltage  (which  maps 
to  the  value  of  a  specified  potentiometer).  TTie  value  is  rounded  to  the  nearest  tenth  of  a 
volt  because  of  limited  measurement  accuracy. 


Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

voltage 

register  int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

voltage/10.0 

float 

+12  volt  power  supply  voltage 

Calls 

Function 

Where  Described 

ain 

Section  2.1. 4.2. 1.1.1 

Table  2.1-456:  current_plusl2  Information. 
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2. 1.4.2. 1.5  cur_plus5.c 

(./simnetAielease/sri-,'libsrc/libdtad/cur_plus5.c) 


Includes: 

"dtadjoc.h" 


2. 1.4. 2. 1.5.1  curreni_plus5 


This  routine  reads  the  +5  volt  power  supply  and  returns  the  current  voltage  (which  maps  to 
the  value  of  a  specified  potentiometer).  The  value  is  rounded  to  the  nearest  hundredth  of  a 
volt  because  of  limited  measurement  accuracy. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

voltage 

register  int 

Standard 

1  Returns  1 

1  Return  Value 

Meaning 

1  voltaae/100.0 

float 

-1-5  volt  power  supply  voltage 

1  Calls  i 

Function 

Where  Described 

ain 

Section  2. 1.4.2. 1.1.1 

Table  2.1-457: 


I 


current_plus5  Information. 
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2. 1.4. 2. 1.6  cur_temp.c 

(./simnet/rclease/src/libsrc/libdtacl/cur_temp.c) 


Includes: 

"dtadjoc.h" 


2. 1.4.2. 1.6.1  current_temperature 

This  routine  returns  the  cunent  temperature  in  degrees  C.  The  temperature  from  the 
thermistor  is  related  to  the  voltage.  The  value  is  rounded  to  the  nearest  whole  number 
because  of  limited  measurement  accuracy.  The  returned  value  is  obtained  from  a  lookup 
table. 

rt  is  the  calculated  thermistor  resistance. 
temp  is  the  temperature-related  voltage. 
r^is  the  reference-related  voltage. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

i 

repister  int 

Standard 

rt 

reaister  int 

Standard 

temp 

register  int 

Standard 

ref 

register  int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

temperature  table[i][01 

1  float 

1  Calls  1 

Function 

Where  Described 

ain 

Section  2. 1.4. 2. 1.1.1 

Table  2.1-458:  current_temperature  Information. 


2. 1.4.2. 1.7  data.c 

(./simnet/rclease/src/libsrc/libdtad/data.c) 

Include  "dtadjoc.h" 


Declarations: 

mb_mapregion  (for  SIMBFLY  machine  only) 
dtad_env  (for  MASSCOMP  machine  only) 
*dtadvaddr  (for  MASSCXDMP  machine  only) 
*pdtad 

real  ly_use_the_dtad 


This  file  defines  the  temperature  table  used  by  the  current_temperature()  routine. 
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2. 1.4. 2. 1.8 


detatch.c 

(./simnet/rclease/src/libsrc/libdtad/detatch.c) 


Includes  "dtadjoc.h" 


2. 1.4.2. 1.8.1  dtad_detach 

This  roudne  detaches  (or  unmaps)  the  Dtad  device  from  the  process. 


1  Calls  1 

Function 

Where  Described 

unmap  mbreoion  (SIMBFLY  machine  only) 

Standard  Butterfly  function 

Dunmap  (MASSCOMP  machine  only) 

Standard  Masscomp  function 

Table  2.1-459:  dtad  detach  Information. 


2. 1.4. 2. 1.9  dtad_loc.h 

(./simnet^lease/src/libsrc/libdtad/dtad_loc.h) 


Includes; 

"stdio.h" 

"multibus.h"  (Butterfly  Machine  only) 
"mbregion.h"  (Butterfly  Machine  only) 
"signal.h"  (Masscomp  Machine  only) 
"setjmp.h"  (Masscomp  Machine  only) 
"sys/types.h"  (Masscomp  Machine  only) 
"sim_types.h" 

"sim_dfns.h" 

"dtad.h" 

Declarations; 

ermo 

pdtad 

really_use_the_dtad 

dtadvaddr 

temperaturc_table[]  [2] 
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2.1.4.2.1.10  init.c 

(ysimnet/release/src/libsrc/libdtad^iLc) 

Includes  "dtadloc.h" 


2.1.4.2.1.10.1  dtad_signal_handler 

This  routine  is  defined  for  the  Masscomp  Machine  only.  It  is  used  to  catch  the  bus  enor 
signal  that  is  sent  if  the  dtad  is  not  in  the  system  when  accessed  in  the  attach  routine.  It 
executes  a  longjmp  (standard  Unix  call)  to  the  location  set  up  by  dtad_init(). 


2.1.4.2.1.10.2  dtad_init 

This  routine  initializes  the  Dtad  device  and  is  called  before  attempting  to  use  the  device. 
The  Dtad  device  is  attached  to  the  calling  process  and  probed  to  determine  whether  it  is 
present  in  the  system.  The  really  use jhe  dtad  flag  is  set  FALSE  if  the  Dtad  is  not  in  the 
system.  A  message  is  printed  about  whether  the  device  was  found.  The  routine  returns  -1 
if  there  is  an  error,  and  0  if  not. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

temp 

char 

Standard 

1  Return  Values  1 

Return  Value 

Meaning 

-1 

int 

error 

0 

int 

procedure  successful 

1  Calls  1 

Function 

Where  Described 

dlad_  attach 

Section  2. 1.4.2. 1.2.1 

Table  2.1-460:  dtad  init  Information. 
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2.1. 


4.2.1.11  uninit.c 

(./simnet/release/src/libsrc/libdtad/uninit.c) 


Includes  "dtad_loc.h" 


2.1.4.2.1.11.1  dtad_uninit 

This  routine  uninitializes  the  Dtad  device. 


1  Calls  1 

Function 

Where  Described 

dtad  detach 

Section  2. 1.4.2. 1.8.1 

Table  2.1>461:  dtad  uninit  Information. 
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2.1J5  Status  Panel  Interface  Software 

The  ^ructure  of  the  Status  Panel  Interface  Software  CSC  is  depicted  in  Figure  2.1-6. 


Fagure  2.1<6:  Structure  of  the  Status  Panel  Interface  Software  CSC. 

To  aud  in  the  successful  operation  and  maintenance  of  a  simulator,  several  components  are 
moninored  in  software  (e.g.,  cig  status,  sound  system  status,  IDC  card  status,  and  network 
status').  Failure  of  a  component  is  indicated  on  an  indicator  panel  associated  with  each 
simuhator.  The  status  data  is  obtained  and  maintained  in  the  vehicle  specific  code  in 
ml_sitatus.c,  m2_status.c,  and  kato_status.c.  The  software  interface  between  the  status 
data  amd  the  indicator  panel  is  accomplished  through  the  library  libbbd.  The  hardware 
interfiace  between  the  simulation  and  the  status  indicator  panel  is  accomplished  through  the 
BuirBrown  MP830-72  TTL  I/O  card.  Libbbd  provides  the  functions  to  communicate  with 
this  KO  card. 

This  Ifunctionality  is  realized  by  the  following  CSUs: 
libbbd 
ml_status.c 
m2_status.c 
kato_status.c 


2. 1.5.1  libbbd 

(./simnet/release/src/libsrc/libbbd  [libbbd]) 

The  Ebrary  libbbd  allows  the  software  interface  between  the  status  data  and  the  indicator 
panel.  It  dso  provides  the  functions  to  communicate  with  the  I/O  card  that  allows  the 
hardware  interface  between  the  simulation  and  the  status  indicator  panel. 


386 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2. 1.5. 1.1  attach.c 

(VsimnetAelease/src/libsrc/libbbd/attach.c) 


This  file  contains  routines  which  attach  the  bbd  device  to  the  process. 


Includes: 

"bbdjoc.h" 

2. 1.5. 1.1.1  bbd_attach 

This  routine  attaches  the  Burr  Brown  device  to  the  process.  A  value  of  0  is  returned  if  the 
attach  process  is  successful,  and  a  value  of  -1  is  returned  otherwise. 

If  a  Butterfly  machine  is  used: 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

-1 

int 

failed 

0 

int 

successful 

Calls 

Function 

Where  Described 

map  mbrepion 

Standard  Butterfly  function 

Table  2.1-462:  bbd^attach  Information  for  the  Butterfly  Machine. 


If  a  Masscomp  machine  is  used: 


I  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

sbrkO 

pointer  to  char 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

-1 

int 

failed 

0 

int 

successful 

Table  2.1-463:  bbd_attach  Information  for  the  Masscomp  Machine. 


2. 1.5. 1.2  bbdjoc.h 

(./simnet/release/src/libsrc/libbbd  /bbdjoc.h) 

This  file  defines "  number  of  constants  and  declares  several  external  variables  for  use  in 
libbbd. 
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2. 1.5. 1.3  bit  in.c 

(./simnet/rcTease/src/libsrc/libbbd/bit_in 


•c) 


This  file  contains  a  procedure  which  reads  a  specified  bit. 


Includes: 

"bbdjoc.h" 


2. 1.5. 1.3.1  bbd_bit_in 

This  routine  reads  a  bit  specified  by  the  argument  bitnum..  This  routine  returns  the  value  in 
the  least  significant  bit  of  the  return  value. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

bitnum 

int 

Standard 

Internal  Variables 

Internal  Variable 

Where  Typedef  Declared 

val 

int 

Standard 

pn 

int 

Standard 

bn 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

the  device  hasn’t  been 
initialized  or  the  value  in  the  bit 
is  equal  to  0 

val 

int 

the  value  in  the  least 
significant  bit  of  the  return 
value 

Table  2.1-464:  bbd  bit  in  Information. 
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2. 1.5. 1.4  bit  out.c 

(ysimnei/reTease/src/libsrc/libbbd/bit_out.c) 


This  nie  contains  a  routine  which  writes  to  the  specified  bit. 

Includes: 

bbdjoc.h" 


2. 1.5. 1.4.1  bbd_bU_out 

This  routine  writes  to  a  specified  bit.  The  arguments  are  the  bit  number  of  the  specified  bit 
(bitnum)  and  the  value  (in  the  least  significant  bit)  to  which  to  set  the  bit.  If  val  is  equal  to 
zero,  a  0  is  written  to  the  bit.  If  val  has  a  nonzero  value,  a  1  is  written  to  the  bit. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

bitnum 

int 

Standard 

val 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

on 

int 

Standard 

bn 

int 

Standard 

temp 

int 

Standard 

Table  2.1-465:  bbd  bit  out  Information. 
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2. 1.5. 1.5  byte_in.c 

(./simnel/release/src/libsrcAibbbd/byte_in.c) 


This  file  contains  a  routine  which  reads  a  specified  byte. 


Includes: 

bbd_loc.h" 


2. 1.5. 1.5.1  bbd_byte_in 

This  routine  reads  a  byte  specified  by  the  argument  portnum.,  which  ranges  in  value  from  0 
to  8.  The  byte  from  the  specified  port  is  returned. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

portnum 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

bbd  not  being  used 

Dbbd->p[Dortnuml  &  OxH 

int 

byte  from  desired  port 

Table  2.1>466:  bbd_byte_in  Information. 


2. 1.5. 1.6  byte_out.c 

(./simnet/release/src/libsrc/libbbd/byte_outc) 


This  file  contains  a  routine  which  writes  to  a  specified  byte. 


2. 1.5. 1.6.1  bbd_byte_out 

This  routine  writes  to  a  byte  specified  by  portnum.,  which  can  have  a  value  of  0  to  8.  val  is 
the  value  to  output  and  can  range  from  0  to  255. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

portnum 

int 

Standard 

val 

int 

Standard 

Table  2.1-467;  bbd_byte_out  Information. 
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2. 1.5. 1.7  control  in.c 

(./simnet/rclease7src/libsrc/libbbd/control_in.c) 


The  control  register  determines  if  the  ports  are  configured  for  inputs  or  outputs.  This  file 
contains  a  routine  which  reads  the  value  of  a  control  register  to  cktermine  the  status  of  the 
ports. 


2. 1.5. 1.7.1  bbd_controMn 

This  routine  reads  the  value  of  a  control  register  to  determine  its  status. 


1  Internal  Variables  | 

Internal  Variable 

Where  Typedet  Declared  j 

val 

int 

Standard  I 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

int 

device  not  in  use  or  the  value 
in  the  register  is  equal  to  0 

val 

int 

the  value  in  the  control 
register 

Table  2.1>468:  bbd  control  in  Information. 


2. 1.5. 1.8  control  out.c 

(./simnet/release^rc/libsrc/libbbd/control_out.c) 

This  file  contains  a  routine  which  writes  to  a  control  register. 


2. 1.5. 1.8.1  bbd_control_out 

This  routine  writes  to  a  control  register,  val  specifies  the  bit  pattern  to  be  written  to  the 
control  register.  This  bit  pattern  determines  the  input/output  status  of  the  ports. 


1  Parameters  I 

Parameter 

Type 

Where  Typedet  Declared 

val 

int 

Standard 

Table  2.1-469:  bbd_control_out  Information. 

2. 1.5. 1.9  data.c 

(./simnet/release/src/libsrc/libbbd/data.c) 

Several  variables  are  declared  in  this  file  for  use  in  libbbd. 
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2.1.5.1.10  detach.c 

(ysimnetAelease/src/libsrc/libbbcl//detach.c) 

This  file  contains  a  routine  which  detaches  the  bbd  device  from  the  process. 


2.1.5.1.10.1  bbd_detach 

This  routine  detaches  the  bbd  device  from  the  process. 


1  Calls 

Function 

Where  Described 

unmap_mbregion  (Butterfly 
only)) 

Standard  Butterfly  functbn 

Table  2.1-470:  bbd  detach  Information. 


2.1.5.1.11  init.c 

(./simnet/release/src/libsrc/libbbd/init.c) 

This  file  contains  routines  which  initialize  the  bbd  device  for  all  outputs. 


Includes: 

"bbdjoc.h" 


2.1.5.1.11.1  bbd  init 


This  routine  initializes  the  bbd  device.  The  argument  is  a  pointer  to  a  character  array 
containing  the  initial  port  values.  The  card  is  initialized  for  all  outputs.  A  value  if  0  is 
returned  if  successful  and  -1  is  returned  otherwise.  A  message  is  printed  which  indicates 
whether  or  not  the  device  was  found. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

£ _ 

pointer  to  char 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

temp 

char 

Standard 

i 

int 

Standard 

Table  2.1-471:  bbd  init  Information. 
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If  a  Butterfly  machine  is  used: 


1  Return  Values  I 

Return  Value 

Type 

Meanina 

-1 

int 

failure 

0 

int 

success 

Calls 

Function 

Where  Described 

bbd_attach 

Section  2. 1.5. 1.1.1 

bbd_control_out 

Section  2. 1.5. 1.8.1 

bbd_byte_out 

Section  2.1. 5.1. 6.1 

Table  2.1-472:  bbd_init  Information  for  the  Butterfly  Machine. 

If  a  Masscomp  machine  is  used: 


1  Return  Values  | 

Return  Value 

Meanina 

-1 

int 

failure 

0 

int 

success 

Calls 

Function 

Where  Described 

bbd_attach 

Section  2. 1.5. 1.1.1 

bbd_controLout 

Section  2. 1.5.1. 8.1 

bbd_byte_out 

Section  2. 1.5. 1.6.1 

Table  2.1-473:  bbd_init  Information  for  the  Masscomp  Machine. 


2.1.5.1.11.2  bbd_signal_handler 

This  routine  handles  the  bus  error  signal  which  can  result  when  determining  if  the  BBD 
card  is  plugged  into  the  system. 


2.1.5.1.12  statistics. c 

(./simnet/release/src/libsrc/libbbd/statistics.c) 


This  file  is  a  stub. 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2.1.5.1.13  status.c 

(ysimnetAielease/src/libsrc/libbbd/status.c) 


This  file  contains  one  routine,  status_out,  which  writes  status  bits  to  a  status  panel. 


Includes: 

"bbdjoc.h" 


2.1.5.1.13  status_out 

This  routine  writes  status  bits  to  a  status  panel.  The  more  significant  status  bits  are  at  lower 
status  addresses  in  the  status  word,  stat  is  the  bit  pattern  which  is  written  to  the  Burr 
Brown  card  and  is  used  to  turn  status  lights  on  and  off. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

stat 

unsianed 

Standard 

Internal  Variables 

Internal  Variable 

Where  Tvoedef  Declared 

pi 

pointer  to  register  unsigned 
char 

Standard 

po 

pointer  to  register  unsigned 
char 

Standard 

Table  2.1>474:  status  out  Information. 
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2.1.5.1.16  uninit.c 

(ysimnei/release/src/libsrc/libbbd/uninit.c) 

This  file  contains  a  routine  which  uninitializes  the  Burr  Brown  device. 


2.1.5.1.16.1  bbd_uninit 

This  routine  uninitializes  the  Burr  Brown  device  and  sets  it  to  all  inputs. 


1  Internal  Variables  | 

1  Internal  Variable 

Type 

Where  Tvpedef  Declared 

b _ _ _ _ 

int 

Standard 

Calls 

Function 

Where  Described 

bbd  detach 

Section  2.1.5.1.10.1 

bbd  rtc  statistics 

Section  2.1.5.1.12 

bbd  bit  out 

Section  2. 1.5.1. 4.1 

bbd  control  out 

Section  2. 1.5. 1.8.1 

Table  2.1-475:  bbd  uninit  Information. 
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2.1.5.2  mljstatus.c 

(./simnest/telease/src/vehicle/ml/src/ml_status.c  [ml_status.c]) 

Includes; 

"sim_types.h” 

’'sim_^is.h'’ 

"net/network.h" 

’’Ubnetwork.h’' 

"Ubidc.h"' 

"Ubidc_dfn.h" 

"libmena_dfo.h" 

"ml_nMam_dfn.h" 

"ml_tuET_pn.h" 

"ml_dri'v_pn.h" 

"ml_anBmo_pn.h" 

"ml_soian_pn.h" 

"ml_staitus.h" 

unsigned  variable  declarations  and  initialization; 
firame_counter 

equipmesit_status  =  RED_HOST  I  RED_CIG  I  RED_SOUND  I  RED_DRrVER  I 

RED_TURRET  I  RED_AMMO  I  RED_12P  I  RED_12N  I 
RED_5P  I  RED.NET 

int  variable  decharations  and  initialization: 
need_to_^set_host_red  =  FALSE 
need_to_;seLcig_red  =  FALSE 
need_to_setjdriver_red  =  FALSE 
need_to_set_tunet_ied  =  FALSE 
need_ta)_set_ammoLred  =  FALSE 
need_ta_set_sound_red  =  FALSE 
need_to_seLvoltagel2P_red  =  FALSE 
need_to_set_voltagel2N_red  =  FALSE 
need_tOL_set_voltage5_red  =  FALSE 
need_tnr:_set_net_i^  =  FALSE 

print_status_messages  =  FALSE  -  controls  status  printing 

dtad_£aifi:ed  ==  FALSE 

unsigned  char  v:ariable  declarations  and  initialization; 
healtiijnost  =  1 
health_cig  =  1 
health_8BOund  =  1 
health_driver  =  1 
health_aHtnmo  =  1 
health_tumet  =  1 
health_net  =  I 

float  variable  declarations  and  initialization: 
voltage!  2P=  12.0 
voltage!  2N  =  -12.0 
voltages  =5.0 
temperature  =  70.0 
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char  airay  declarations  and  initialization; 

st_cora[]  =  {HEADOO,  HEADOl,  IDC.STATUS) 
st_sound[]  =  {/*HEAD00,HEAD01  */  SOUND.STATUS} 

2. 1.5. 2.1  whaMs_voltagel2P 

This  routine  returns  the  variable  voltagellP. 


1  Return  Values  I 

Return  Value 

Type 

Meanina 

voltaael2P 

float 

voltaoe 

Table  2.1-476:  whatJs_voltagel2P  Information. 
2. 1.5. 2. 2  whaMs_voltagel2N 

This  routine  returns  the  variable  voltagellN. 


1  Return  Values  1 

Return  Value 

Meanina 

voltaQel2N 

float 

voltaoe 

Table  2.1-477:  whaMs_voltagel2N  Information. 
2. 1.5. 2. 3  what__is_voltage5 

This  routine  returns  the  vaxidhlevoltageS. 


I  Return  Values  I 

Return  Value 

Type 

Meanina 

voltaoeS 

float 

voltaoe 

Table  2.1-478:  what_is_voltage5  Information. 


2. 1.5. 2. 4  whatjs_temperature 
This  routine  returns  the  variable  temperature. 


I  Return  Values  I 

Return  Value 

Type 

Meanina 

temperature 

float 

temperature. 

Table  2.1-479:  what_is_temperature  Information. 


2. 1.5. 2. 5  status_preset 

This  routine  presets  entries  in  the  shared  memory  so  the  first  execution  of  status_simul 
does  not  indicate  failures. 
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2.1.SJ£.6  status  init 


This  Tomine  presets  entries  in  the  shared  memory  by  calling  status_preset,  and  then  calls 
status_ovit. 


1  Calls  1 

Functlotn 

Where  Described 

status  ouit 

Section  2.1.5.1.13 

Table  2.1-480:  status  init  Information. 


2. 1.5.2. 7  status_simul 

This  toumne  monitors  the  status  of  the  devices  during  the  simulation. 


1  Calls  1 

Function) 

Where  Described 

monitor  sstatus 

Section  2.1.5.2.23 

Table  2.1-481:  status  simul  Information. 


2 . 1 .5  JE .  8  status_print_temp_and_supplies 


This  routdne  displays  the  current  values  of  the  temperature  and  the  power  supplies,  as 
measured  and  cdculated  from  the  I/O  card  on  the  console. 


1  Calls  1 

Functicnn 

Where  Described 

current  tiemperature 

Section  2.1 .4.2.1. 6.1 

current  Ci;lus5 

Section  2.1 .4.2. 1.5.1 

current  I9ius12 

Section  2.1. 4.2.1. 4.1 

current  rtninus12 

Section  2.1 .4.2. 1.3.1 

Table  2.1-482:  status_print_temp_and_supplies  Information. 


2. 1.5.2. 9  driver_dead 

This  routdne  indicates  that  the  driver  IDC  is  dead. 


1  Parameters  1 

ParamaHer 

Where  Tvpedef  Declared 

B 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintt 

Section  2.1.1.3.1.34.1 

Table  2.1-483:  driver  dead  Information. 
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2.1.5.2.10  turret  dead 


This  routine  indicates  that  the  turret  IDC  is  dead. 


1  Parameters  1 

1  Parameter 

Type 

Where  Tvpedef  Declared 

Ie _ _ _ 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1  « 

Table  2.1<484:  turret  dead  Information. 


2.1.5.2.11  ammo  dead 


This  routine  indicates  that  the  ammo  IDC  is  dead. 


I  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

£ 

pointer  to  char 

Standard 

I  Calls  I 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-485:  ammo  dead  Information. 


2.1.5.2.12  cig_dead 

This  routine  indicates  that  the  CIG  is  dead. 


1  Parameters  1 

1  Parameter 

Where  Typedef  Declared 

Ie _ _ _ 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-486:  cig_dead  Information. 


I 
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2.1.5.2.13  net_dead 

This  routine  indicates  a  network  problem. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

1  Dointertochar  1 

Standard 

Calls 


Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-487:  net  dead  Information. 


2.1.5.2.14  ser  dead 


This  routine  indicates  that  the  ser  (hpsm)  card  is  dead. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

£ 

Dointerto  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-488:  ser  dead  Information. 


2.1.5.2.15  dtad  dead 


This  routine  indicates  that  the  dtad  card  is  dead. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

P 

1  pointer  to  char  1 

Standard 

Calls 


Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-489:  dtad  dead  Information. 
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2.1.5.2.16  sound_dead 

This  routine  indicates  that  the  sound  system  is  dead. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

B 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-490:  sound  dead  Information. 


2.1.5.2.17  plusl2_dead 

This  routine  indicates  that  the  +12  volt  supply  has  gone  awry. 


I  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

B 

pointer  to  char 

Standard 

I  Calls  I 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-491:  plusl2_dead  Information. 


2.1.5.2.18  minusl2_dead 

This  routine  indicates  that  the  -12  volt  supply  has  gone  awry. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

B 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-492:  minusl2  dead  Information. 
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2.1.5.2.19  pius5_dead 

This  routine  intScates  that  the  +5  volt  supply  has  gone  awry. 


_  Parameters 


inter  to  char 


Parameter 


Function 


norintf 


Calls 


Where  Described 


Section  2.1.1.3.1.34.1 


Where  Typedef  Declared 


Standard 


Table  2.1*493:  plus5_dead  Information. 
2.1.5.2.2&  enable_status_printing 

This  routine  enalbles  printing  of  status  messages  by  setting  the  variable 
print_status_me«sages  to  TRUE. 

2.1.5.2.21  4lisable_status_printing 

This  routine  (fisables  printing  of  status  messages  by  setting  the  variable 
print_status_mffissages  to  FALSE. 


2.1.5.2.22  cigjailedjsm 

This  routine  is  a  finite  state  machine  that  is  called  in  the  event  of  CIG  failure.  It  indicates 
that  the  CIG  is  dead  and  checks  the  equipment  status  every  second,  and  broadcasts  the 
equipment  status  onto  the  net  every  minute. 


Internal  Variable 


now 


Ein 


Internal  Variables 


Where  Typedef  Declared 


Standard 


Standard 


Standard 


Standard 


Calls 

Function 

Where  Described 

network_canJ_r»eally_use_ne 

twork 

Section  2.1.1.3.2.27.1 

net  current  time 


network  oet  nes  handle 


ciQ  dead 


monitor  status 


Section  2.1.1.3.2.12.1 


Section  2.1.5.2.12 


Section  2.1.5.2.23 


Table  2.1-494:  cig_failed_fsm  Information. 
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2.1.5.2.23  inonitor_status 

This  routine  checks  the  status  of  the  various  subsystems.  Each  subsystem  is  checked  on  a 
different  frame.  A  flag  is  set  for  each  subsystem  that  fails.  On  the  final  firame  of  the  cycle 
the  flags  are  checked  and  the  lights  are  updated. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

which 

int 

Standard 

Internal  Variables 

Internal  Variable 

Type 

Where  Tvpedef  Declared 

last  heartbeat 

int 

Standard 

new  heartbeat 

int 

Standard 

Calls 

Function 

Where  Described 

driver  dead 

Section  2.1. 5.2.9 

fifo  enqueue 

Section  2.6.8.2.1 

turret  dead 

Section  2.1.5.2.10 

ammo  dead 

Section  2.1.5.2.11 

network_canJ_really_use_ 

network 

Section  2.1.1.3.2.27.1 

net  heartbeat 

network  oet  net  handle 

Section  2.1.1.3.2.12.1 

net  dead 

Section  2.1.5.2.13 

ser  heartbeat 

Section  2.6.7.2.1 

ser  dead 

Section  2.1.5.2.14 

net  xmt  failed 

Section  2.1.1.3.1.24.1 

set  xmt  failed 

Section  2.1.1.3.1.56.1 

dtad  dead 

Section  2.1.5.2.15 

sound  dead 

Section  2.1.5.2.16 

current  temperature 

Section  2.1 .4.2. 1.6.1 

current  dIus12 

Section  2.1. 4.2.1. 4.1 

dIus12  dead 

Section  2.1.5.2.17 

current  minus12 

Section  2.1. 4.2.1. 3.1 

minusl2  dead 

Section  2.1.5.2.18 

current  plus5 

Section  2.1. 4.2.1. 5.1 

plusS  dead 

Section  2.1.5.2.19 

status  out 

Section  2.1.5.1.13 

Table  2.1-495:  monitor  status  Information. 
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2.1.5.3  in2_status.c 

(7simneiAelease/src/vehicle/m2/src/m2_status.c  [m2_status. 


c]) 


Includes; 

"sim_types.h" 

"sim_dtfns.h" 

"net/network,h 

"libnetwork.h" 

"Ubidc.h" 


It 


"Ubidc_dfn.h" 

"libmem_dfn.h" 

"m2_mem_dfn.h" 

"m2_turr_p’..h" 

"m2_driv_pn.h" 

"m2_soun_pn.h" 

"m2_status.h" 

Tifo.h" 

"fifo_dfn.h" 

"status.h" 

"ser_status.h" 

"dtad.h" 


unsigned  variable  declarations  and  initializadon: 
frame_counter 

equipment_status  =  RED_HOST  I  RED_CIG  I  RED_SOUND  I  RED_DRrVER 
RED.TURRET  I  RED_12P  I  RED_12N  I 
RED_5PIRED  NET 


int  variable  declarations  and  initialization: 
need_to_set_host_ied  =  FALSE 
need_to_set_ci^red  =  FALSE 
nced_to_set_driver_red  =  FALSE 
need_to_set_tunet_rcd  =  FALSE 
need_to_set_sound_red  =  FALSE 
need_to_set_voltagel2P_red  =  FALSE 
need_to_set_voltagel2N_red  =  FALSE 
need_to_set_voltage5_red  =  FALSE 
need_to_set_net_i^  =  FALSE 

print_status_messages  =  FALSE  -  controls  status  printing 

dtad_faaed  =  FALSE 


unsigned  char  variable  declarations  and  initialization: 
health_host  =  1 
health_cig  =  1 
health_sound  =  1 
health_driver  =  1 
health_turret  =  1 
health_net  =  1 
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float  variable  declarations  and  initialization: 
voltagel2P  =  12.0 
voltagel2N  =  -12.0 
voltages  =  5.0 
temperature  =  70.0 

char  array  declarations  and  inidalization: 

st_com[]  =  {HEADOO,  HHADOl,  IDC_STATUS} 
st_sound[]  =  {/*HEAD00,HEAD01  */SOUND_STATUS} 

extern  int  variable  declarations: 
netxmt_failed 


2. 1.5.3. 1  what_is_voItagel2P 

This  routine  returns  the  variable  voltagellP. 


1  Return  Values  1 

Return  Value 

Meanina 

voitaQe12P 

float 

voltaqe 

Table  2.1<496:  what_is_voltagel2P  Information. 


2. 1.5. 3. 2  what_is_voItagel2N 
This  routine  returns  the  variable  voltage  12N, 


1  Return  Values  i 

Return  Value 

Meanina 

voltage12N 

float 

voltage 

Table  2.1-497:  what_is_voltagel2N  Information. 


2. 1.5. 3. 3  what_is_voltage5 

This  routine  returns  the  variable  voltageS. 


I  Return  Values  I 

Return  Value 

Type 

Meanina 

voltages 

float 

voltage 

Table  2.1-498:  whatJs_voltage5  Information. 
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2. 1.5. 3. 4  what_is_temperature 

This  routine  returns  the  variable  temperature. 


1  Return  Value  1 

Return  Value 

Meaning 

temperature 

float 

temperature. 

Table  2.1-499:  what_is_teniperature  Information. 


2. 1.5. 3. 5  status_preset 

This  routine  presets  entries  in  the  shared  memory  so  the  first  execution  of  status_simul 
does  not  indicate  failures. 


2. 1.5. 3. 6  status_init 

This  routine  presets  entries  in  the  shared  memory  by  calling  status_preset,  and  then  calls 
status_out. 


1  Calls  1 

Function 

Where  Described 

status  out 

Section  2.1.5.1.13 

Table  2.1-500:  status  init  Information. 


2. 1.5. 3. 7  status_simul 

This  routine  monitors  the  status  of  devdces  during  the  simulation. 


I  Calls  I 

Function 

Where  Described 

monitor  status 

Section  2.1.5.3.23 

Table  2.1-501:  status  simul  Information. 


406 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2 . 1 . 5 . 3 . 8  status_pr  int_temp_and_supplies 

This  routine  displays  the  current  values  of  the  temperature  and  the  power  supplies,  as 
measured  and  c^culated  from  the  I/O  card  on  the  console. 


1  Calls  1 

Function 

Where  Described 

current  temperature 

Section  2.1. 4.2.1. 6.1 

current  plusS 

Section  2.1.4.2.1.5.1 

current  plus12 

Section  2.1. 4.2.1. 4.1 

current  minusl  2 

Section  2.1.4.2.1.3.1 

Table  2.1>502:  status_print_temp_and_supplies  Information. 


2. 1.5. 3. 9  driver  dead 


This  routine  indicates  that  the  driver  IDC  is  dead. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

£ 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1*503:  driver  dead  Information. 


2.1.5.3.10  turret  dead 


This  routine  indicates  that  the  turret  IDC  is  dead. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

2 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1*504:  turret  dead  Information. 
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2.1.5.3.11  cig^dead 

This  routine  indicatsss  that  the  CIG  is  dead. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

B 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-505:  cig_dead  Information. 


2.1.5.3.12  netjdead 

This  routine  indicates  a  network  problem. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

S. 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-506:  net  dead  Information. 


2.1.5.3.13  serjdead 

This  routine  indicates  that  the  ser  (hpsm)  card  is  dead. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

£ 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-507:  ser  dead  Information. 
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2.1.5.3.14  dtad_dead 

This  routine  indicates  that  the  dtad  card  is  dead. 

1  Parameters  1 

Parameter 

Where  Typedef  Declared 

£ 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table 

2.1-508:  dtad_dead  Information. 

2.1.5.3.15  sound_dead 

This  routine  indicates  that  the  sound  system  is  dead. 

1  Parameters  1 

{Parameter 

Where  Tvpedef  Declared 

IP _ _ _ 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

norintf 

Section  2.1.1.3.1.34.1 

Table  2.1-509:  sound  dead  Information. 


2.1.5.3.16  plusl2_dead 


This  routine  indicates  that  the  +12  volt  supply  has  gone  awry. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

P 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

norintf 

Section  2.1.1.3.1.34.1 

Table  2.1-510:  plusl2_dead  Information. 
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2.1.5.3.17  ininusl2_dead 

This  routine  indicates  that  the  -12  volt  supply  has  gone  awry. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

£ 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1>511:  ininusl2  dead  Information. 


2.1.5.3.18  plus5_dead 

This  routine  indicates  that  the  +5  volt  supply  has  gone  awry. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

£ 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-512:  plus5_dead  Information. 


2.1.5.3.19  enable_status_pr inting 

This  routine  enables  printing  of  status  messages  by  setting  the  variable 
print_status_mes sages  to  TRUE. 


2.1.5.3.20  disable_status_printing 

This  routine  disables  printing  of  status  messages  by  setting  the  variable 
print_status_messages  to  Fi^SE. 
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2.1.5.3.21  cig_failed_fsm 


This  routine  is  a  finite  state  machine  that  is  called  in  the  event  of  CIG  failure.  It  indicates 
that  the  CIG  is  dead  and  checks  the  equipment  status  every  second,  and  broadcasts  the 
equipment  status  onto  the  net  every  minute. 


1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

now 

Iona 

Standard 

temp 

int 

Standard 

seconds 

int 

Standard 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

network_can_i_really_use_ 

network 

Section  2.1.1.3.2.27.1 

net  current  time 

network  aet  net  handle 

Section  2.1.1.3.2.12.1 

cia  dead 

Section  2.1.5.3.12 

monitor  status 

Section  2.1.5.3.23 

Table  2.1*513:  cig_failed_fsm  Information. 
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2.1.5.3.22  monitor  status 


This  routine  checks  the  status  of  the  various  subsystems.  Each  subsystem  is  checked  on  a 
different  frame.  A  flag  is  set  for  each  subsystem  that  fails.  On  the  final  frame  of  the  cycle 
the  flags  are  checked  and  the  lights  are  updated. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

which 

int 

Standard 

1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

last  heartbeat 

int 

Standard 

new  heartbeat 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

driver  dead 

Section  2.!. 5.3.9 

fifo  enaueue 

Section  2.6.8.2.! 

turret  dead 

Section  2.!.5.3.!0 

network_canJ_really_use_ 

network 

Section  2.!.!. 3.2.27.! 

net  heartbeat 

network  aet  net  handle 

Section  2.!.!.3.2.!2.! 

net  dead 

Section  2.!  .5.3.! 3 

ser  heartbeat 

Section  2.6.7.2.! 

ser  dead 

Section  2.!.5.3.!4 

net  xmt  failed 

Section  2.!.! .3.! .24.! 

set  xmt  failed 

Section  2.!.! .3.! .56.! 

dtad  dead 

Section  2.!. 5.3.! 5 

sound  dead 

Section  2.!  .5.3.!  6 

current  temperature 

Section  2.!.4.2.!.6.! 

current  dIus12 

Section  2.! .4.2.!. 4.! 

Dlus12  dead 

Section  2.!. 5.3.! 7 

current  minus! 2 

Section  2.!. 4.2.!. 3.! 

minus! 2  dead 

Section  2.!  .5.3.! 8 

current  plusS 

Section  2.!. 4.2.!. 5.! 

plus5  dead 

Section  2.!.5.3.!9 

status  out 

Section  2.!.5.!.!3 

Table  2.1-514:  monitor  status  Information. 
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2.1.5.4  kato  status.c 

(./simnet^lease/src/vehicle/kato/src/kato_status.c  [kato_status.c] ) 

Includes: 

"sim_types.h" 

"sim_dfns.h" 

"nel/network.h" 

"libnetwork.h" 

"libidc.h" 

"Ubidc_(ifn.h" 

"libmem_dfn.h" 

"kato_mem_dfn.h" 

"kato_hard.h"  if  USE_SPACEBALL  not  defined 

"kato_soft.h" 

"kato_soun_pn.h" 

"kato_status.h" 

"fifo.h" 

"fifo.dfn.h" 

"status.h" 

"cmc.h" 

"cinc_status.h" 

"ser_status.h" 

"dtad.h" 

unsigned  variable  declarations  and  initialization: 
frame_counter 

equipment.status  =  RED.HOST  1  RED.CIG  I  RED_SOUND  I  RED.HARD  I 

RED.SOFT  I  RED_12P  I  RED_12N  I  RED_5P  I  RED.NET 

int  variable  declarations  and  initialization: 
need_to_set_host_red  =  FALSE 
need_to_set_cig_red  =  FALSE 
need_to_set_haTd_red  =  FALSE 
need_to_set_soft jred  =  FALSE 
need_to_set_sound_red  =  FALSE 
need_to_set_voltagel2P_red  =  FALSE 
need_to_set_voltagel2N_red  =  FALSE 
need_to_set_voltage5_red  =  FALSE 
need_to_set_net_i^  =  FALSE 

print_status_messages  =  FALSE  -  controls  status  printing 

dtad_failed  =  FALS^: 

unsigned  char  variable  declarations  and  initialization: 
health_host  =  1 
health_cig  =  1 
heaith_sound  =  1 
health_haid  =  1 
health_soft  =  1 
health_net  =  1 
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float  variable  declarations  and  initialization; 
voltagel2P=  12.0 
voltagel2N  =  -12.0 
voltages  =  5.0 
temperature  =  70.0 

char  array  declarations  and  initialization: 

st_comI]  =  {HEADOO,  HEADOl,  IDC_STATUS) 
st_sound[]  =  {/*HEAD00,HEAD01,*/SOUND_STATUS} 

extern  int  variable  declarations: 
netxmt_failed 


2. 1.5. 4.1  what_is_voltagel2P 

This  routine  returns  the  variable  voltagellP. 


1  Return  Values  1 

Return  Value 

Meanina 

voltaael2P 

float 

voltaae. 

Table  2.1-S15:  what_is_voltagel2P  Information. 


2. 1.5. 4. 2  what_is_voltagel2N 

This  routine  returns  the  variable  voltagel2N. 


I  Return  Values  1 

Return  Value 

Meaning 

voltaael2N 

float 

voltaae. 

Table  2.1-516:  what_is_voltagel2N  Information. 


2. 1.5. 4. 3  what_is_voltage5 
This  routine  returns  the  variable  voltageS. 


1  Return  Values  1 

Return  Value 

Meaning 

voltaaeS 

float 

voltaae. 

Table  2.1-517;  what_is_voltage5  Information. 
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2. 1.5. 4. 4  what_is_temperature 


This  routine  returns  the  variable  temperature. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

temperature 

float 

temperature. 

Table  2.1-518:  what_is_temperature  Information. 

2. 1.5. 4. 5  status_preset 

This  routine  presets  entries  in  the  shared  memory  so  the  first  execution  of  status_simul 
does  not  indicate  failures. 

2. 1.5. 4. 6  statusjnit 

This  routine  presets  entries  in  the  shared  memory  by  calling  status_preset,  and  then  calls 
status_out. 


1  Calls  1 

Function 

Where  Described 

status  out 

Section  2.1.5.1.13 

Table  2.1-519:  statusjnit  Information. 
2. 1.5. 4. 7  status_simui 

This  routine  monitors  devices  during  the  simulation. 


1  Calls  1 

Function 

Where  Described 

monitor  status 

Section  2.1.5.4.23 

Table  2.1-520:  status_simul  Information. 

2 . 1 . 5 . 4 . 8  status_print  Jemp_and_supplies 

This  routine  displays  the  current  values  of  the  temperature  and  the  power  supplies,  as 
measured  and  calculated  from  the  I/O  card  on  the  console. 


1  Calls  I 

Function 

Where  Described 

current  temperature 

Section  2.1. 4.2.1. 6.1 

current  plus5 

Section  2.1. 4.2.1. 5.1 

current  plus12 

Section  2.1. 4.2.1. 4.1 

current  minus12 

Section  2.1. 4.2.1. 3.1 

Table  2.1-521:  status_printjemp_and_supplies  Information. 
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2. 1.5. 4. 9  hard_dead 

This  routine  indicates  that  the  hard  IDQs  dead.  This  routine  is  compiled  only  if 
USE_SPACEBALL  is  not  defined. 


1  Parameters  1 

1  Parameter 

Type 

Where  Tvpedef  Declared 

IE _ _ _ 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1*522:  hard  dead  Information. 


2.1.5.4.10  soft  dead 


This  routine  indicates  that  the  soft  IDCis  dead. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

E 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1*523:  soft^dead  Information. 


2.1.5.4.11  cig_dead 

This  routine  indicates  that  the  CIG  is  dead. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

E 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1*524:  cig_dead  Information. 
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2.1.5.4.12  net  dead 


This  routine  indicates  a  network  problem. 


1  Parameters  1 

■  Parameter 

Where  Tvoedef  Declared 

Le _ _ _ 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table 

2.1-525:  net_dead  Information. 

2.1.5.4.13  ser_dead 

This  routine  indicates  that  the  ser  (hpsm)  card  is  dead. 

1  Parameters  1 

1  Parameter 

Where  Tvoedef  Declared 

IE _ _ _ 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-526:  ser  dead  Information. 


2.1.5.4.14  dtad  dead 


This  routine  indicates  that  the  dtad  card  is  dead. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

E 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-527:  dtad  dead  Information. 
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2.1.5.4.15  sound_dead 

This  routine  indicates  that  the  sound  system  is  dead. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

^ 

1  pointer  to  char  I 

Standard 

Calls 


Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-528:  sound  dead  Information. 


2.1.5.4.16  plusl2_dead 


This  routine  indicates  that  the  +12  volt  supply  has  gone  awry. 


I  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

£ 

pointer  to  char 

Standard 

I  Calls  I 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-529:  plusl2_dead  Information. 


2.1.5.4.17  minusl2  dead 


This  routine  indicates  that  the  -12  volt  supply  has  gone  awry. 


1  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

B 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

nprintf 

Section  2.1.1.3.1.34.1 

Table  2.1-530:  minusl2  dead  Information. 
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2.1.5.4.18  plus5_dead 


This  routine  indicates  that  the  +5  volt  supply  has  gone  awry. 


1  Parameters  1 

Parameter 

Tvne 

Where  Tvpedef  Declared 

2 _ 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

norintf 

Section  2.1.1.3.1.34.1 

Table  2.1-531:  plus5_dead  Information. 


2.1.5.4.19  enable_status_printing 

This  routine  enables  printing  of  status  messages  by  setting  the  variable 
print_status_messages  to  TRUE. 


2.1.5.4.20  disable_status_printing 

This  routine  disables  printing  of  status  messages  by  setting  the  variable 
print_status_messages  to  FALSE. 


2.1.5.4.21  cig_failed_fsm 


This  routine  is  a  finite  state  machine  that  is  called  in  the  event  of  CIG  failure.  It  indicates 
that  the  CIG  is  dead  and  checks  the  equipment  status  every  second,  and  broadcasts  the 
equipment  status  onto  the  net  every  minute. 


I  Internal  Variables  I 

Internal  Variable 

Where  Tvoedef  Declared 

now 

Iona 

Standard 

temp 

int 

Standard 

seconds 

int 

Standard 

i 

int 

Standard 

I  Calls  I 

Function 

Where  Described 

net  current  time 

network  qet  net  handle 

Section  2.1.1.3.2.12.1 

da  dead 

Section  2.1.5.4.12 

monitor  status 

Section  2.1.5.4.23 

Table  2.1-532:  cig_failed_fsm  Information. 
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2.1.5.4.22  monitor_status 

This  routine  checks  the  status  of  the  various  subsystems.  Each  subsystem  is  checked  on  a 
different  frame.  A  flag  is  set  for  each  subsystem  that  fails.  On  the  final  frame  of  the  cycle 
the  flags  are  checked  and  the  lights  are  updated. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

which 

int 

Standard 

1  Internal  Variables  1 

Internal  Variable 

Where  Typedef  Declared 

last  heartbeat 

int 

Standard 

new  heartbeat 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

hard  dead 

Section  2.1 .5.4.9 

fifo  enqueue 

Section  2. 6.8. 2.1 

soft  dead 

Section  2.1.5.4.10 

cmc  heartbeat 

net  dead 

Section  2.1.5.4.13 

ser  heartbeat 

Section  2.6.7.2.1 

ser  dead 

Section  2.1.5.4.14 

net  xmt  failed 

Section  2.1.1.3.1.24.1 

set  xmt  failed 

Section  2.1.1.3.1.56.1 

dtad  dead 

Section  2.1.5.4.15 

sound  dead 

Section  2.1.5.4.16 

current  temperature 

Section  2.1. 4.2.1. 6.1 

current  dIus12 

Section  2.1. 4.2. 1.4.1 

dIus12  dead 

Section  2.1.5.4.17 

current  minus12 

Section  2.1 .4.2.1. 3.1 

minus12  dead 

Section  2.1.5.4.18 

current  plusS 

Section  2.1. 4.2.1. 5.1 

plusS  dead 

Section  2.1.5.4.19 

status  out 

Section  2.1.5.1.13 

Table  2.1-533:  monitor  status  Information. 
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2.1.6  Keyboard  Interface  Software 


The  C  archive  library  libkeybrd  provides  a  device-independent  interface  to  read  characters 
from  the  host  keyboard.  This  interface  is  used  for  development  /debugging.  Once  each 
frame,  the  simulation  host  checks  if  a  key  has  been  pressed.  If  it  has,  the  key-press  is 
interpreted  by  vehicle  specific  routines  in  ml_keybrd.c,  m2_keybrd.c,  and  kato_keybrd.c. 
The  structure  of  this  CSC  is  depicted  in  Figure  2.1-7.  This  functionality  is  realized  by  the 
following  CSUs: 


libkeybrd 

ml_keybrd.c 

m2_keybrd.c 

kato_keybrd.c 


Figure  2.1-7  Keyboard  Interface  Software  structure. 


2. 1.6.1  libkeybrd 

(./simnet/release/src/libsrc/libkeybrd  [libkeybrd]) 

Libkeybrd  contains  the  routines  for  maintaining  a  machine  independent  interface  for  the 
terminal  keyboard. 


2. 1.6. 1.1  close. c 

(./simnet/release/src/libsrc/libkeybrd/close.c) 

This  file  contains  the  routine  for  closing  a  libkeybrd  type  tty  connection. 
Includes: 

"stdio.h"  (Simnet  Butterfly  Machines  only) 

"keyjoc.h" 


421 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2. 1.6. 1.1.1  keybrd_tty_close 

This  routine  closes  the  terminal  keyboard. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

desc 

int 

Standard 

Table  2.1-534:  keybrd_tty_close  Information. 


2. 1.6. 1.2  init.c 

(./simnet/release/src/libsrc/libkeybrti/init.c) 

This  file  contains  routines  for  initializing  raw  tty  inputs. 


If  Simnet  Butterfly  Machine,  includes: 
"stdio.h" 

"fnctLh" 

"key_loc.h" 


If  Masscomp  Machine,  includes: 
''fnctl.h" 

"sys/ioctl.h" 

"termio.h" 

"keyjoc.h" 


2. 1.6. 1.2.1  keybrd_tty_init 


This  routine  does  the  machine  hardware  dependent  operations  and  returns  a  raw  file 
descriptor  for  use  by  the  application  in  referencing  the  tty  (in  read,  write,  and  close 
functions).  Note  that  tty  0  is  assumed  to  be  the  Simulation  console. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

tty 

int 

Standard 

mode 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

fd 

int 

Standard 

stio 

struct  termio 

Standard 

device  named  21 

char 

Standard 

1  Return  Values  I 

Return  Value 

Meaning 

fd 

int 

a  handle  for  subsequent  calls 
to  libkeybrd 

Table  2,1-535: 


keybrd_tty_init  Information  for  Masscomp  .Machine. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

tty 

int 

Standard 

mode 

int 

Standard 

1  Return  Values  I 

Return  Value 

Meanina 

tty 

int 

a  handle  for  subsequent  calls 
to  libkeybrd 

1  Calls  1 

Function 

Where  Described 

ChannelHasInput 

Table  2.1-536:  keybrd_tty_init  Information  for  Simnet  Butterfly  Machine. 


2. 1.6. 1.3  key_Ioc.h 

(,/simnet/release/src/libsrc/libkeybrd/key_loc.h) 

This  file  contains  definitions  needed  only  in  libkeybrd. 
Defines: 

USE_CONSOLE 

USE_HOSTIN  (for  Butterfly  Machine) 
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2. 1.6. 1.4  read.c 

(./simnet/release/src/libsrc/libkeybrd/read.c) 

Includes: 

"keyjoc.h" 

"sttho.h"  (for  Simnet  Butterfly  Machine) 


2. 1.6. 1.4.1  keybrd_tty_read 

This  routine  reads  one  character  from  the  terminal  keyboard. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

desc 

int 

Standard 

1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

kev 

char 

Standard 

1  Return  Values  1 

Return  Value 

Meanina 

kev 

char 

the  next  character  in  the  buffer 

0 

int 

no  character  is  in  the  buffer 

Table  2.1-537:  keybrd__tty_read  Information  for  Masscomp  Machine. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

desc 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

kev 

char 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

kev 

char 

the  next  character  in  the  buffer 

0 

no  character  is  in  the  buffer 

Table  2.1-538:  keybrd_tty_read  Information  for  Simnet  Butterfly  Machine. 
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2.1.6.1.5  reset.c 

(./simnet/rclease/src/libsrc/libkeybrd/reset.c) 

Includes: 

"keyjoc.h" 

"sy^ioctl.h"  (for  Masscomp  Machine) 
"tennio.h"  (for  Masscomp  Machine) 
"stdio.h"  (for  Butterfly  Machine) 


2. 1.6. 1.5.1  keybrd_tty_reset 

This  routine  resets  the  terminal  keyboard  back  to  normal  parameters  after  use  by  the 
simulation. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

desc 

int 

Standard 

1  Internal  Variables  1 

Variable 

Where  Tvoedef  Declared 

stio 

struct  termio 

Standard 

Table  2.1*539:  keybrd_tty_reset  Information  for  Masscomp  Machine. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

desc 

int 

Standard 

Table  2.1-540: 


keybrd_tty_reset  Information  for  Butterfly  Machine. 
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2 . 1 .6 . 3 . 7  keyboard_exit_gracefuny 

This  routine  resets  the  keyboard  and  closes  the  connection. 


1  Calls  1 

Function 

Where  Described 

keyboard  reset  terminal 

Section  2. 1.6.3. 6 

Table  2.1-551; 


key  boa  rd_exi  t_gracef ul  iy  Information . 
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2. 1.6. 1.6  write.c 


Includes: 

"key_loc.h" 

"stdio.h"  (for  Simnet  Butterfly  Machine  only) 


2.1.6.1.6.1  keybrd_tty_write 

This  routine  writes  characters  to  the  terminal. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

desc 

int 

Standard 

data 

Dointer  to  char 

Standard 

size 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

write(des, data, size) 

int 

For  Masscomp  Machine  Only; 
writes  to  terminal. 

-1 

int 

For  Butterfly  Machine: 
not  supported. 

Table  2.1>541:  keybrd  tty_write  Information. 
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2.1.6.2  inl_keybrd.c 

(/simnet/release/src/vehicle/ml/src/nil_keybrd.c  [nil_keybrd.c]) 


This  file  contains  the  Ml  specific  routines  required  to  interface  with  the  terminal  keyboard. 


"stdio.h" 

"fcntl.h" 

"signal.h" 

"termio.h" 

"sim_dfns.h" 

"sim_types.h" 

"sim_macros.h" 

"rtc.h" 

"pro_sim.h" 

"pro_data.h" 

"repair_ml.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

’•libfail.h" 

"librepair.h" 

"libmem_dfn.h" 

"libnetwork.h" 

"timers.h" 

"libsound.h" 

"libhullh" 

"libkin.h" 

"libfilter.h" 

"librva.h" 

"ml_main.h" 

"ml_cntrl.h" 

"ml_elecsys.h" 

"ml_ammo_pn.h" 

"ml_engine.h" 

"mljaser.h" 

"ml_fuelsys.h" 

"ml_weapons.h" 

"ml_tracks.h" 

"ml_turret.h" 

"ml_dtrain.h" 

"ml_vision,h'' 

"ml_repair.h" 

"ml_sound.h" 

"ml_ammo.h" 

"ml_keybrd.h" 

"ml_cupola.h" 

"status.h" 

"ml_status.h" 

"ml_turr_pn.h" 

"ml_driv_pn.h" 

"net/network.h" 

"enpioctl.h" 


if  SIMBFLY  not  defined 
if  SIMBFLY  not  defined 


if  SIMBFLY  not  defined 
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Includes: 

"enpsvr.h”  if  SIMBFLY  defined 


Value 
0.005 

int  variable  declarations  and  initialization: 
console 

use_keyboard  =  FALSE 
use_cupola  =  FALSE 

REAL  variable  declarations  and  initialization: 
lpscope_value  =  0.0 
cws_value  =  0.0 

PointCTS  to  REAL  typedef  declarations: 
vec 

Procedure  declarations: 

keyboard_setup_terminal() 


Defines: 

Symbol 

DELTA.POT 


2. 1.6. 2.1  keyboard_really_use 
This  routine  enables  the  keyboard. 

2. 1.6. 2. 2  keyboard_use_cupoIa 

This  routine  sets  the  variable  usejcupola  to  TRUE  and  displays  a  message  that  cupola  and 
periscope  are  now  under  keyboard  control. 


2. 1.6. 2. 3  keyboard_init 

This  routine  initializes  the  keyboard. 


1  Calls  1 

Function 

Where  Described 

keyboard  setup  terminal 

Section  2.1. 6.2.5 

cupola  Ipscope  new  value 

Section  2.3.6.1 

cupola  cws  new  value 

Section  2.3.6.1.2.4 

Table  2.1-542:  keyboardjnit  Information. 
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2. 1.6. 2. 4  keyboard_simui 

If  SIMBFLY  is  defined,  the  long  variable  pkt  cnt  start  is  declared  prior  to  this  routine. 
This  routine  takes  the  appropriate  action  for  a  key  hit  by  a  user. 


Internal  Variables 


Internal  Variable 


cmd 


network  statsfN  STATS 


network  statst 


n 


Where  Typedef  Declared 


Standard 


Standard 


Standard 


Standard 


Errors 

Error  Name 

Reason  for  Error 

KEYBOARD:  caniget 
network  statistics 

A  call  to  netj)rint_statistics  returned  -1 . 

KEYBOARD:  cant  zero 
network  statistics 

A  call  to  net_zero_statistics  returned  -1 . 

Function 


kevbrd  ttv  read 


fail  break  system 


reconstitute  from  keyboard 


repair  stop  repair 


controls  break  controls 


controls  restore  controls 


deactivate  simulation 


filter  dump  filter  info 


repair  fix  system 


network  oet  vehicle  force 


eiectsys  battery  failure 


rva  dump  priority  lists 


rint 


rva  turn  debuo  on 


rva  turn  debuo  off 


vision  break  all  blocks 


controls  kill  radio 


controls  restore  radio 


use  static  debu 


controls  eiectsys  dead 


controls  eiectsys  reborn 


sound  reset 


fail  cat  kill 


fuel  init  tanks 


repair  all  systems 


cupola  cws  new  value 


network  print  statistics 


status_print_temp_and_ 


Calls 


Where  Described 


Section  2.1. 6.1. 4.1 


Section  2.5.4.8.1 


Section  2.1.1.3.2.18.7 


Section  2.2.2 


Section  2.2.2 


Section  2.5. 1.1 .4 


Section  2.5.14.4.1 


Section  2.5.4.19.3 


Section  2.1.1.3.1.17.1 


Section  2.2.6.3.1.17 


Section  2.5.12.2.3 


Section  2.5.12.2.1 


Section  2.5.12.2.2 


Section  2.3.6.3.2.9 


Section  2.5.1 .1.2 


Section  2.2.2 


Section  2.2.2 


Section  2.1.2.2.2.116.1 


Section  2.2.2 


Section  2.2.2 


Section  2.5.4.9.1 


Section  2.2.5.2.1 


Section  2.5.4.19.7 


Section  2.2.6.1.2.4 


Section  2.1.1.3.2.16.1 


Section  2.1. 5.2.8 
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tOQQle  Qunner  vision  state 

Section  2.2.6.4.3.33 

tOQQle  driver  vision  state 

Section  2.2.6.4.3.32 

print  view  modes 

Section  2.2.6.4.3.34 

HELP  PRINT1 

Sim  macros.h 

HELP  PRINT2 

Sim  macros.h 

ammo  restore  ammo 

Section  2.2.5.1.65 

controls  restore  ammo 

Section  2.2.2 

timers  status 

Section  2.6.3.17.1 

net  print  statistics 

nprintf 

Section  2.1.1.3.1.34.1 

net  zero  statistics 

turret  send  azimuth  ind 

Section  2.5.5.2.18 

turret  null  azimuth  ind 

Section  2.5.5.2.17 

bbd  rtc  statistics 

network  aet  vehicle  id 

Section  2.1.1.3.1.22.1 

network  qet  exercise  id 

Section  2.1.1.3.1.16.1 

kinematics  aet  o  to  h 

Section  2.5.8.1.4 

ammo  print  statistics 

Section  2.2.5.1.69 

print  reasons 

Section  2.5.16.3.6 

vision  cmdrs  binoculars 

Section  2.2  6.4.3.6 

get  ballistics  debug 

Section  2.1. 2.2  6.2 

set  .ballistics  debug 

Section  2.1.2.2.6.1 

rtc  print  permanent 

Section  2.6.16.1.11 

Table  2.1-543:  keyboard^simul  Information. 


2 . 1 . 6 . 2 . 5  keyboard_setup_terminal 

This  routine  sets  up  the  keyboard  to  be  read  by  an  application. 


1  Calls  1 

Function 

Where  Described 

keybrd  ttv  init 

Section  2. 1.6.1. 2.1 

Table  2.1-544:  keyboard_setup_terminal  Information. 


2 . 1 . 6 . 2 . 6  key  board_reset_terminal 

This  routine  resets  the  keyboard  before  exiting  the  application. 


1  Calls  1 

Function 

Where  Described 

keybrd  tty  reset 

Section  2. 1.6. 1.5.1 

Table  2.1-545:  keyboard_reset_terminal  Information. 
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2 . 1 . 6 . 2 . 7  key  board_exit_gracefully 

If  the  keyboard  was  enabled,  this  routine  resets  the  keyboard  and  closes  the  connection. 


1  Calls  1 

Function 

Where  Described 

keyboard  reset  terminal 

Section  2.1. 6.2.6 

kevbrd  tty  close 

Section  2.1 .6.1. 1.1 

Table  2.1>546:  keyboard_exit_gracefully  Information. 
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2.1.6.3  in2_keybrd.c 

(/simne^release/src/vehicle/m2/src/ni2_keybrd.c  [m2_keybrd.c]) 

This  file  contains  the  M2  specific  routines  required  to  interface  with  the  terminal  keyboard. 

Includes: 

"stdio.h" 

"fcntl.h" 

"signal.h"  if  SIMBFLY  not  defined 

"termio.h"  if  SIMBFLY  not  defined 

"sim_dfns.h" 

"sim_types.h" 

"rtc.h" 

"pro_sim.h" 

"pro_data.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"libcig.h" 

"libfail.h" 

"librcpair.h" 

"libmain.h" 

"libmem_dfn.h'' 

"libnetwork.h" 

"timers.h" 

"libsound.h" 

"libhullh" 

"libkin.h" 

"librva.h" 

"m2_cntrl.h" 

"m2_tuiTet.h" 

"m2_sound.h" 

"m2_keybrd.h" 

"tn2_dtrain.h" 

"m2_cupola.h" 

"status.h" 

"m2_status.h" 

"net/network.h" 

"m2_fuelsys.h" 

"in2_cig.h" 

"m2_isu.h" 

"m2_firecU.h" 

"m2_ammo.h" 

"m2_weapons.h" 

"m2_main.h" 

"m2_vision.h" 

"m2_driv_pn.h" 

"m2_turr_pn.h" 

"fifo.dfn.h" 

"m2_mem_dfn.h" 

"fifo.h" 

"enpioctl.h"  if  SIMBFLY  not  defined 

"enpsvr.h"  if  SIMBFLY  defined 
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Defines: 

Symbol 

MAXHELDS 

DELTA.POT 

int  variable  declarations  and  initialization; 
mask 

use_keyboaid  =  FALSE 
use_cupola  =  FALSE 

REAL  variable  declarations  and  initialization: 
cws_value  =  0.0 

Pointers  to  REAL  typedef  declarations: 
vec 

Procedure  declarations; 

keyboard_setup_terminal() 


Value 


32 

0.005 


2. 1.6.3. 1  keyboard_really_use 

This  routine  enables  the  keyboard. 


2. 1.6. 3. 2  keyboard_use_cupola 


This  routine  sets  the  variable  use_cupola  to  TRUE  and  displays  a  message  that  cupola  is 
now  under  keyboard  control. 


2. 1.6. 3. 3  keyboard_init 

This  routine  initializes  the  keyboard. 


1  Calls  1 

Function 

Where  Described 

keyboard  setup  terminal 

Section  2.1. 6.3.5 

cupola  cws  new  value 

Section  2. 3. 6.1. 2.4 

Table  2.1-547;  keyboard_init  Information. 
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2. 1.6. 3. 4  keyboard_simuI 

This  routine  takes  the  appropriate  action  for  a  key  hit  by  a  user. 


Internal  Variable 


cmd 


local  mask 


network  statsfN  STATS 


network  statst 


n 


list 


num  vehs 


Internal  Variables 


e 


char 


int 


int 


char 


int 


pointer  to  pointer  to 
RVA  ENTRY 


int 


Where  Typedef  Declared 


Standard 


Standard 


Standard 


Standard 


Standard 


librva.h 


Standard 


Error  Name 


KEYBOARD;  can't  get 
network  statistics 


KEYBOARD:  can't  zero 
network  statistics 


Errors 


Reason  for  Error 


A  call  to  net_print_statistics  returned  -1 . 


A  call  to  net_zero_statistics  returned  -1 . 


Function 


ammo  print  ammo  variables 


reconstitute  froit:  keyboard 


drivetrain  parkinq  brake  set 


drivetrainj3arking_brake_ 

release 


controls  break  controls 


controls  restore  controls 


filter  dumo  filter  info 


s  mao  4x 


firecti  Qps  mao  4x 


s  maq  4x 


ammo  aos  mao  4x 


s  maq  12x 


firecti  qps  maq  12x 


isu  qps  mao  I2x 


ammo  ops  maq  I2x 


transmission  dum 


drivetrain  set  brake 


rva  dump  priority  lists 


silent  mode  on 


silent  mode  off 


rva  turn  debuq  on 


rva  turn  debuq  off 


atinq  conditions 


ammo_ready_to_external_ 


Calls 


Where  Described 


Section  2.3.5.1.68 


Section  2.1.1.3.2.18.7 


Section  2.3.6.2.4.12 


Section  2.3.6.2.4.13 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


2.3.2 


2.3.2 


2.5.14.4.1 


2.3.6.3.2.4 


2.3.2.2.3.3 


2.3.63.3.4 


2.3.5.1.45 


2.3.6.32.3 


2.3.2.2.3.4 


2.3.6.3.3.3 


2.3.5.1.44 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


2.3.6.2.4.11 


2.5.12.2.3 


2.3. 1.1.1 


2.3.1.1.2 


2.5.12.2.1 


2.5.12.2.2 


2.5.1. 1.2 


2.3.5.3.15 


2.3.5.1.70 
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keybrd_ammo_carriers_near_ 

here 


controls  receive  flash 


controls  receive  off 


weapons  kevbrd  fire 


fail  cat  kill 


fuel  init  tanks 


repair  all  systems 


controls  electsys  reborn 


cupola  cws  new  value 


network  print  statistics 


statusj3nntjemp_and_ 


ammo  restore  ammo 


timers  status 


net  print  statistics 


nprintf 


net  zero  statistics 


lint  br  values 


et  ballistics  debu 


set  ballistics  debu 


ammo  round  indexed  status 


kinematics  oet  o  to  h 


et  db 


nra  oet  close  list 


rint  reasons 


Section  2.3.5.3.35 


Section  2.1.2.2.2.116.1 


Section  2.3.2 


Section  2.3.2 


Section  2.3.3.2.21 


Section  2.5.4.9.1 


Section  2.2.5. 2.1 


Section  2.5.4.19.7 


Section  2.3.2 


Section  2.3.6. 1.2.4 


Section  2.1.1.3.2.16.1 


Section  2.1. 5.2.8 


Section  2.2.5.1.65 


Section  2.6.3.17.1 


Section  2.1.1.3.1.34.1 


Section 


Section  2.3.6.3.2.24 


Section  2.1 .2.2.6  2 


Section  2.1.2.2.6.1 


Section  2.3.5.1.28 


Section  2.5.8. 1.4 


Section  2.2.1.33.1 


Section  2.5.12.9.1 


Section  2.5.16.3.6 


Table  2.1>548:  keyboard_simul  Information. 


2 . 1 . 6 . 3 . 5  keyboard_setup_terminal 


This  routine  sets  up  the  keyboard  to  be  read  by  an  application. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Typedef  Declared 

fd 

int 

Standard 

stio 

struct  termio 

termio. h 

Table  2.1*549:  keyboard_setup_terminal  Information. 


2 . 1 . 6 . 3 . 6  keyboard_reset_terminal 


This  routine  resets  the  terminal  before  exiting  the  application. 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

fd 

int 

Standard 

stio 

struct  termio 

termio. h 

Table  2.1-550:  keyboard_reset_terminal  Infornuitiun. 
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2.1.6.4  kato  keybrd.c 

(/siinnet/release/src/vehicle/kato/src/kato_keybrd.c  [kato_keybrd.c]) 

This  file  contains  the  Stealth  vehicle  specific  routines  required  to  interface  with  the  terminal 

keyboard. 

Includes: 

"stdio.h" 

"fcntl.h" 

"sim_dfns.h" 

"sim_types.h" 

"rtc.h" 

"pro_sim.h" 

"pro_data.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h" 

"Ubfailh" 

"librcpair.h" 

"libmem_dfn.h" 

"libnetwork.h" 

"timers.h" 

"Ubsound.h" 

"libhull.h" 

"Ubkin.h" 

"Ubrva.h" 

"kato_cntrl,h" 

"kato_keybrd.h" 

"status.h" 

"kato_status.h" 

"kato_sound.h" 

"net/net  work.h" 

"kato_cntrllr.h" 

"kato_state.h" 

"kato_view.h" 

"enpioctl.h"  if  SIMBFLY  not  defined 

"enpsvr.h"  if  SIMBFLY  defined 


Defines: 

Symbol  Yalus 

TTY.CONSOLE  0 

int  variable  declarations  and  initialization: 
console_desc 
use_keyboard  =  FALSE 

Pointers  to  REAL  typedef  declarations: 
vec 

Procedure  declarations: 

keyboard_setup_terminal() 
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2. 1.6. 4. 2  keyboard_init 


This  routine  initializes  the  keyboard. 


1  Calls  1 

Function 

Where  Described 

keyboard  setup  terminal 

Section  2.1. 6.4.5 

Table  2.1-552:  keyboard_init  Information. 
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2. 1.6. 4. 3  keyboard_simuI 

This  routine  takes  the  appropriate  action  when  a  user  hits  a  key. 


Internal  Variables 


Internal  Variable 


cmd 


Where  Tvoedef  Declared 


Standard 


Standard 


Error  Name 


KEYBOARD:  cant  get 
network  statistics 


KEYBOARD:  cant  zero 
network  statistics 


Errors 


Reason  for  Error 


A  call  to  net_print_statistics  returned  -1 . 


A  call  to  net  zero  statistics  returned  -1 . 


Function 


kevbrd  ttv  read 


view  aet  pitch  anole 


controls  break  controls 


controls  restore  controls 


state  vehicle  detach 


filter  dump  filter  info 


view  centered 


state  tooale  fix 


rva_dump_orionty  lists 


state  mimic 


rva  turn  debug  on 


rva  turn  debug  off 


vehicle  restart 


state  saf  mode  on 


state  saf  mode  off 


state  terrain  follow  on 


state  terrain  follow  off 


state  vel  attach 


state  world  attach 


state  orbit  attach 


veh  set  force 


network  set  force 


network  print  statistics 


statusj3rint_temp_and_ 


timers  status 


net  print  statistics 


nprmtf 


kinematics  get  o  to  h 


et  n  mapped 


rint  reasons 


Where 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Calls 


Described 


2.1. 6.1. 4.1 


2.1.2.2.9.13 


2.4.2 


2.4.2 


2.4.8.2 


2.5.14.4.1 


2.1.2.2.9.6 


2.4.8.2 


2.5.12.2.3 


2.4.8.2 


2.5.12.2.1 


2.5.12.2.2 


2.5. 1.1.2 


2.5.19.1.7 


2.4.8.2 


2.4.8.2 


2.4.8.2 


2.4.8.2 


2.4.8.2 


2.4.8.2 


2.4.8.2 


2.6.10.6.2 


2.1.1.3.1.50.1 


2.1.1.3.2.16.1 


2.1. 5.2.8 


Section  2.6.3.17.1 


Section  2.1.1.3.1.34.1 


Section  2. 5. 8. 1.4 


Section  2.1.2.2.2.34.1 


Section  2.5.16.3.6 


Table  2.1-553:  keyboard_simul  Information. 
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2 . 1 . 6 . 4 . 4  keyboard_setup_terminal 

This  routine  sets  the  keyboard  to  be  read  by  an  application. 


1  Calls  1 

Function 

Where  Described 

keybrd  ttv  init 

Section  2. 1.6. 1.2.1 

Table  2.1-554:  keyboard_setup_terminaI  Information. 


2 . 1 . 6 . 4 . 5  keyboard_reset_terminal 

This  routine  resets  the  keyboard  before  exiting  the  application. 


I  Calls  I 

Function 

Where  Described 

kevbrd  ttv  reset 

Section  2.1 .6. 1.5.1 

Table  2.1-555:  keyboard_reset_terminal  Information. 


2 . 1 .6 .4 . 6  keyboard_exit_gracefulIy 


This  routine  resets  the  keyboard  and  closes  the  connection. 


1  Calls  1 

Function 

Where  Described 

keyboard  reset  terminal 

Section  2.1. 6.4.6 

keybrd  ttv  close 

Section  2.1 .6.1 .1.1 

Table  2.1-556: 


keyboard_exit_gracefully  Information. 
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2.1.7  Spaceball  Interface  Software 
Figure  2.1-8  shows  the  structure  of  this  CSC. 


Figure  2.1>8:  Spaceball  Interface  Software  structure. 

Two  CSUs  arc  associated  with  the  Spaceball  Interface.  They  arc  libspaceball  and 
kato_sb.c. 


2.1.7.1  libspaceball 

(/simnet/rclease/sic/vehicle/libsrc/Iibspaceball  [libspaceball]) 


Code  contained  in  the  libspaceball  files  is  licensed  for  use  and  distribution  by  Spatial 
Systems,  Inc.  Refer  to  the  Spaceball  Application  Developer’s  Refercnce  (Spatial  Systems, 
Inc.  Document  Number  DIOiOS)  for  more  infoi  natic.i. 


2. 1.7. 1.1  sbcustom.c 

(/simnet/rclease/src/vehicle/libsrc/libspaceball/sbcustom.c) 
Spaceball  Library  RS232-C  I/O  and  Clock  Routines  for  UNIX 


The  Spaceball  Library  interfaces  with  the  operating  system  via  the  routines  contained  in  this 
file: 


SbOpenO 

SbCloseO 

SbInputO 

SbOutputO 

SbMillisecondsO 


“  open  the  Spaceball  tty 

-  close  the  currcntly  open  Spaceball  tty 

-  rcad  in  characters  from  Spaceball 

-  send  characters  to  Spaceball 

“  rctums  the  lowest  16  bits  of  a  millisecond  clock 
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2. 1.7. 1.2  sblibry.c 

(/simnet/releas^src/vehicle/libsrc/libspacebalVsblibry.c) 

Spaceball  Library  Routines 

This  file  provides  the  functionality  to  convert  between  Spaceball  data  formats  and 
application  data  formats.  Every  effort  has  been  made  to  allow  simple  configuration 
parameters  to  be  set  in  "sbcustom.h"  so  as  to  meet  the  requirements  of  a  wide  variety  of 
applications.  The  use  of  the  routines  contained  in  this  file  is  strongly  recommended  to  save 
implementation  time  and  effort  and  to  ensure  portability. 


2. 1.7. 1.3  sbtest.c 

(/simnet/release/src/vehicle/libsrc/libspaceball/sbtest.c) 

Spaceball  Library  Test  Program 

This  file  provides  a  simple  test  program  to  verify  the  operation  of  Spaceball. 


2. 1.7. 1.4  sbtute.c 

(/simnetAelease/src/vehicle/libsrc/libspaceball/sbtute.c) 

Spaceball  Library  Tutorial  Example 

This  file  contains  template  routines  which  can  be  used  and  built  upon  by  application 
programmers.  It  is  written  in  a  tutorial  fashion. 


2. 1.7. 1.5  sbcustom.h 

(/sirruiet/release/stc/vehicle/libsrc/libspaceball/sbcustom.h) 

This  file  is  the  configuration  file  for  the  Spaceball  Library  Unix  implementation. 


2. 1.7. 1.6  sblibry.h 

(/simnet/release/src/vehicle/libsrc/libspaceball/sblibry.h) 

Spaceball  Library  Include  File 

This  file  provides  the  definitions  and  declarations  required  to  use  the  Spaceball  Library  and 
should  be  included  in  each  program  utilizing  the  library. 


442 


BBN  Systems  and  Technologies 


Vehicles  CSQ 


2.1.7.2  kato_sb.c 

(/simnet/release/src/vehicle/kato/src/kato_sb.c  [kato_sb.c] ) 

Includes; 

"stdio.h" 

"simstdio.h" 

"sblibry.h" 

"basic.h" 

"sim_types.h’’ 

"sim_macros.h" 

"kato_state.h" 


Defines: 

Sb_ENVIRONMENT_INCLUDES 

ForcelD  declaration  and  initialization: 
force  =  otherForcelD 

int  variable  declarations  and  initialization: 
tran_on  =  TRUE 
rot_on  =  TRUE 
dominant  =  FALSE 

SbUintlti  declaration: 
b_period 

float  declarations  and  initialization: 
trans_gain_factor  =  0.2 
rot_gain_factor  =  0.2 
trans_gain  =  3.0 
rot_gain  =  5.0 
tran_vec[3] 
rot_vec[3] 


2. 1.7. 2.1  spaceball_simul 


1  Internal  Variables  1 

1  Internal  Variable 

Where  Typedef  Declared 

char 

Standard 

Inow 

SbUint16 

COTS  Spaceball  software 

1  Calls  1 

Function 

Where  Described 

SbCheckSpaceball 

COTS  Spaceball  software 

SbRequestBallData 

COTS  Spaceball  software 

Table  2.1>557:  spaceball_simul  Information. 
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2. 1.7. 2.2  spaceball_exit 


1  Calls  1 

Function 

Where  Described 

SbSetBallMocte 

COTS  Soaceball  software 

SbClose 

COTS  Spaceball  software 

Table  2.1-558:  spaceball_exit  Information. 


2. 1.7. 2. 3  initiaUze_spaceball 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

ttv  line 

pointer  to  char 

Standard 

1  Errors  I 

Error  Name 

Reason  for  Error 

Could  not  opren  Spaceball  on 

A  call  to  SbOpen  returned  a  value  <  0. 

Spaceball  did  not  appear  to 
respond  on  ...  •  continuing 
anvwav 

SbReset(TRUE)  returned  -1. 

1  Calls  1 

Function 

Where  Described 

SbOpen 

COTS  Spaceball  software 

SbReset 

COTS  Spaceball  software 

SbSetBaliMode 

COTS  Spaceball  software 

SbRezero 

COTS  Spaceball  software 

SbSetT  ranslationFee  1 

COTS  Spaceball  software 

SbSetRotationFeel 

COTS  Spaceball  software 

SbSetNullResqion 

COTS  Spaceball  software 

SbRequestBiallOata 

COTS  Spaceball  software 

Table  2.1-559:  initialize_spaceball  Information. 


2. 1.7. 2. 4  display_data 


1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

now 

SbUint16 

COTS  Spaceball  software 

1  Calls  1 

Function 

Where  Described 

SbMilliseconcfs 

COTS  Spaceball  software 

Table  2.1-560:  display_data  Information. 
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2. 1.7. 2. 5  mypressed 


1  Parameters  1 

1  Parameter 

Type 

Where  Tvpedef  Declared 

Ikevs 

SbUint16 

COTS  Spaceball  software 

Calls 

Function 

Where  Described 

SbBeep 

COTS  Spaceball  software 

SbSetBallMode 

COTS  Spaceball  software 

handles_pil_thumbJower_ 

depressed 

Section  2.4.2 

veh  set  force 

Section  2.6.10.6.2 

network  set  force 

Section  2.1.1.3.1.50.1 

SbRezero 

COTS  Spaceball  software 

handlesj3il_trigger_l  _ 
depressed 

Section  2.4.2 

Table  2.1-561:  mypressed  Information. 


2. 1.7. 2. 6  my  translate 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

period 

SbUint16 

COTS  Spaceball  software 

vecf31 

SbReal 

COTS  Spaceball  software 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

translations 

VECTOR 

Sim  types. h 

i 

int 

Standard 

Calls 

Function 

Where  Described 

SbDominant 

COTS  Spaceball  software 

min 

Sim  macros.h 

max 

Sim  macros.h 

controller  main  cyclic  Iona 

Section  2.4.8.1 

controller  main  cyclic  lateral 

Section  2.4.8.1 

controller  main  collective 

Section  2.4.8. 1 

Table  2.1-562:  mytranslate  Information. 
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2. 1.7. 2. 7  myrotate 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

period 

SbUint16 

COTS  Spaceball  software 

vecfSI 

SbReal 

COTS  Spaceball  software 

1  Internal  Variables  I 

Internal  Variable 

Where  Typedef  Declared 

rotations 

VECTOR 

Sim  tvpes.h 

pitch  rate 

REAL 

Sim  types. h 

i 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

Sb  Dominant 

COTS  Spaceball  software 

min 

Sim  macros.h 

max 

Sim  macros.h 

pedal  tail  rotor  collective 

Section  2.4 

state  return  attach  mode 

Section  2.4.8.2 

state  return  attach  state 

Section  2.4.8.2 

Sion 

Sim  macros.h 

view  set  pitch  rate 

Section  2.1.2.2.9.5 

Table  2.1-563: 


myrotate  Information 
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2.2  Ml  Vehicle  Simulation  Functions 

A  distributed  vehicle  simulation  performs  a  set  of  tasks  each  frame.  It  checks  the  state  of  its 
controls,  updates  lights  and  meters,  checks  its  failure/repair  model,  manages  munitions, 
models  its  hull  (and  turret)  subsystems,  does  kinematics/dynamics,  simulates  weapons,  and 
communicates  with  the  outside  world.  This  cycle  of  tasks  is  referr^  to  below  as  the  main 
simulation  loop. 

■nie  structure  of  the  Ml  Vehicle  Simulation  Software  CSC  is  shown  in  Figure  2.2-1. 


Figure  2.2>1:  Ml  Vehicle  Simulation  Software  CSC  structure. 

The  second  level  CSC's  that  make  up  this  CSC  are  as  follows: 

Top  Level  Ml  Simulation  Software 
Ml  (Controls  /  Switchology 
Ml  Weapons 
Ml  Failures 

Ml  Munitions  Management 
Ml  Vehicle  Model 
Ml  Network  Interactions 
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2.2.1  Top  Level  Ml  Simulation  Software 

The  main  vehicle  simulation  loop  is  executed  once  each  frame.  Vehicle  specific  simulation 
routines  are  called  by  the  one  csu,  ml_main.c. 


Figure  2.2-2: 

Ml  Top  Level  Vehicle  Software  CSC  structure. 

2.2. 1.1  ml_main.c 

(/simneL/release/src/vehicle/ml/src/ml_main.c  [ml_main.c]) 

This  file  contains  routines  used  in  the  SIMNET  simulation  of  the  Ml  Abrams  Main  Battle 

Tank. 

Includes: 

"stdio.h" 

"ctype.h" 

"  signal. h" 

"sim_dfns.h" 

"sim_macros.h” 

"sim_types.h" 

"mass_stdc.h" 

"dgi_stdg.h" 

"sim_cig_if.h’' 

"pro_assoc.h" 

"pro_sim.h" 

"status.h" 

"status  ml.h" 

"veh  type.h" 

"fifo.dfn.h" 

"fifo.h" 

"bigwheel.h" 

"UbteiTain.h" 

"libkin.h" 

"libfaiLh" 

"libcig.h" 

"libms'  .h" 

"bbd.h" 

"libhull.h" 

"libidc.h" 

"libmain.h" 

"libmem.h" 

"libnetwork.h" 

"librepair.h" 

"librva.h" 

"libsusp.h" 

"libturret.h" 

"libsound.h" 

"libmap.h" 

"ml  ammo.h" 

"ml_bcs.h" 

"ml.cntrl.h" 

"ml_cupola.h" 

"ml  dtrain.h" 

"ml  elecsys.h" 

"ml_failure.h" 

"ml_firectl.h" 

"ml_fuelsys.h" 

"ml_handles.h" 

"ml_hydrsys.h" 

"ml_keybrd.h" 
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"mljaser.h" 
ml_meter.h" 

"ml_repair.h" 

"ml_sound.h" 

"ml_turret.h" 

”ml_status.h" 

"timers.h" 

"status.h" 

"cmc.h” 

"cmc_status.h" 

The  following  are  declared: 
debug 

print_overruns 
guise_override 
guise_to_use 
exitO 

The  following  are  declared  for  the  '-p'  switch: 
init_activ 
inidal_activation 

The  following  is  defined: 

PARS.FILE 


"ml.main.h" 

"ml_pots.h" 

"ml_resupp.h" 

"ml_weapons.h" 

"ml_vision.h" 

"ml_thennal.h" 

"dtad.h" 

"ser_status.h" 

"cnic_timers.h" 


2.2. 1.1*1  print_help 

This  routine  prints  out  data  for  the  Ml  simulation. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

proaname 

pointer  to  char 

Standard 

Table  2.2-1:  print_help  Information. 


2.2. 1.1.2  print_veh_logo 

This  routine  prints  a  logo  for  the  Ml  vehicle. 
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2. 2. 1.1. 3  veh_spec_startup 

This  routine  sets  up  the  network  and  CIG  interfaces  at  startup.  In  addition,  the  simulator  type  is 
set  and  the  damage  tables  are  initialized. 


1  Calls  1 

Function 

Where  Described 

rtc  init  clock 

Section  2.6.16.1.14 

network  set  simulator  type 

Section  2.1.1.3.1.53.1 

use  ciQ  reconfia  startup 

ciQ  set  view  confiq  file 

Section  2.1.  2.2.2.23.1 

aet  vconfiQ  filet 

Section  2.5. 1.2.2 

map  vehicle  file  read 

Section  2.6.11.5.1 

pet  veh  map  file 

Section  2.5. 1.2.5 

map  read  asid  file 

Section  2.6.11.4.1 

aet  asid  map  file 

Section  2.5.1. 2.4 

map  file  read 

Section  2.6.11.3.1 

aet  ammo  map  file 

Section  2.5. 1.2.6 

keyboard  init 

Section  2. 1.6.2 

failure  init 

Section  2.2.4.1.1 

map  aet  damaae  files 

Section  2.6.11.1.1 

Table  2.2-2:  veh_spec_startup  Information. 


2. 2. 1.1. 4  veh_specjdle 

This  routine  is  called  while  the  simulator  is  in  the  IDLE  state. 


I  Calls  1 

Function 

Where  Described 

status  simul 

Section  2. 1.5.2 

keybrd  simul 

Section  2. 1.6.2 

io  simul  idle 

Section  2.1.2.2.5.1.2 

process  activate  request 

Section  2. 1.1. 3.2. 1.1 

network  qet  exercise  id 

Section  2.1.1.3.1.16.1 

Table  2.2-3:  veh_spec_idle  Information. 
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2.2. 1.1.5  veh_spec_init 

Order  dependent  initializations  are  performed  for  all  of  the  Ml's  subsystems  while  the 
simulator  is  in  the  SIMINTT  state. 


1  calls  1 

1  Function 

Where  Described 

Wl  .M  1:1  ill— 

Section  2.2.6.1.2 

sound  init 

Section  2.1. 3.2.4 

status  oreset 

Section  2.1. 5.2 

controls  fsm  init 

Section  2.2.2 

resupply  init 

Section  2.2.5.3.28 

meter  init 

Section  2.2.2.3.1 

electsvs  init 

Section  2.2.6.3.17 

hydraulic  init 

Section  2.2.6.4.2 

firecti  init 

Section  2.2.2.2.3 

drivetrain  init 

Section  2.2.6.2.1.41 

handles  init 

Section  2.2.2.2.2 

laser  init 

Section  2.2.3.2 

bcs  init 

Section  2.2.3.1 

weapons  init 

Section  2. 2.3.3 

vision  restore  all  blocks 

Section  2.2.6.4.3 

controls  edae  init 

Section  2.2.2 

Section  2.2.7.1.5 

thermal  init 

Section  2.2.6.4.4 

confiQ  pos  init2 

Section  2.1.2.2.2.24.2 

kinematics  qet  o  to  h 

Section  2.5.8.2.4 

kinematics  qet  w  to  h 

Section  2.5.8.2.1 

ciq  init  ctr 

Section  2. 1.2.2. 6.3 

Table  2.2-4:  veh_spec_init  Information. 
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2. 2. 1.1. 6  veh_spec_siinulate 


This  routine  calls  the  routines  which  simulate  the  various  functins  of  the  Ml's  subsystems  on  a 
tick  by  tick  basis. 


1  Internal  Variables  | 

internal  Variable 

Where  Typedef  Declared 

start 

Iona 

Standard 

end 

Iona 

Standard 

Calls 

Function 

Where  Described 

status  simuf 

Section  2. 1.5.2 

keyboard  simul 

Section  2.1. 6.2 

sound  simul 

Section  2.1. 3.2.6 

controls  simul 

Section  2.2.2 

handles  simul 

Section  2.2.2.2.2 

ammo  simul 

Section  2.2.5.11.2 

resupply  simul 

Section  2.2.5.3.29 

electsys  simul 

Section  2.2.6.3.1.1 

hydraulic  simul 

Section  2.2. 6.4.2. 1 

fuel  simul 

Section  2.2.5.2.3 

driyetrain  simul 

Section  2.2.6.2.1.40 

bcs  simul 

Section  2.2.3. 1 

weapons  simul 

Section  2.2.3.3 

cupola  simul 

Section  2.2.6.1.2 

thermal  simul 

Section  2.2.6.4.4 

Table  2.2*5:  veh_spec_simulate  Information. 


2. 2. 1.1. 7  veh_spec_stop 

This  routine  is  called  while  the  simulator  is  in  the  SIMSTOP  state.  The  IDC  and  sound  system 
hardware  is  reinitialized,  and  the  vision  blocks  are  broken  (all  screens  are  blackened). 


1  Calls  1 

Function 

Where  Described 

idc  init 

Section  2.1.4.1.1.24.1 

sound  init 

Section  2.1. 3.2.4 

yision  break  all  blocks 

Section  2.2.6.4.3 

Table  2.2-6:  veh_spec_stop  Information. 
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2.2. 1.1.8  veh_spec_exit 

This  routine  is  called  while  the  simulator  is  in  the  SIMEXIT  state.'  Simulation  statistics  are 
printed,  and  the  network  connection  is  closed. 


1  Internal  Variables  I 

Internal  Variable 

Where  Tvpedef  Declared 

num  ticks 

int 

Standard 

1  Calls  1 

1  Function 

Where  Described 

Section  2.1. 6.2 

timers  aet  current  time 

Section  2.6.3.2.1 

timers  aet  current  tick 

Section  2.6.3.1.1 

timers  elapsed  milliseconds 

Section  2.6.3.10.1 

network  print  statistics 

Section  2.1.1.3.2.16.1 

net  close 

Section  2.20.2.3.1  in  MCC  CSCI  SDD 

Table  2.2-7:  veh_spec_exit  Information. 
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2. 2. 1.1. 9  main 


This  routine  loops  through  the  Ml  simulation  once  each  frame.  The  generic  simulation 
routines  in  "libmain"  is  called  by  this  routine. 


The  parameters 

are  are  read  in  and  parsed; 

case -a 

The  request  send  and  receive  sizes  are  set  and  assymetric  is  set  to 
on. 

The  ammo  autoloader  is  enabled 

case -A 

case-c 

Keyboard  use  cupola  is  set 

case-C 

catc  mode  is  set. 

case-d 

Debugging  is  turned  on. 

case-D 

Debugging  for  static  vehicles  is  turned  on. 

case-e 

The  ethemet  is  closed. 

case-E 

The  exercise  ID  is  set 

case  -F 

cfail  debug  is  on. 

case  -g 

The  CIG  isn't  using  graphics. 

case  -G 

Guise  override  is  set  on. 

case  -h 

Print  help 

case  -? 

Print  help 

case-k 

The  keyboard  is  in  use. 

case-1 

Not  used. 

case-m 

Status  printing  is  disabled. 

case  -n 

Verbose  mode  is  used. 

case  -N 

Night  vision  is  enabled. 

case  -0 

Printing  of  overruns  is  enabled. 

case  -p 

The  simulator  is  started  in  stand  alone  mode.  The  simulator  acts  as  if  it 
received  an  activation  packet  from  the  M(X.  This  segment  of  code  is 
similar  to  that  used  by  the  MCC  for  activationg  a  simulator. 

case-P 

Proximity  list  debugging  is  on. 

case  -s 

Sound  isn’t  used. 

case  -S 

The  network  device  is  set. 

case  -t 

Use  the  database  override  named. 

case-T 

The  DED  names  are  set. 

case-v 

Terrain  verbosS  mode  is  on. 

case-1 

CIGl  is  set. 

case -2 

CIG2  is  set. 

case-z 

The  vehicle  size  scale  is  changed. 

1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard 

arav 

pointer  to  char 

Standard 
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Internal  Variable 


initial  headin 


status 


unit 


status  bits 


Internal  Variables 


e 


int 


float 


pointer  to 

SIMNET  M1  Status 


pointer  to 

GroundVehicleSubsystems 


inter  to  OroanizationalUnit 


unsioned  int 


Where  Typedef  Declared 


Standard 


Standard 


stat_m1.h 


status.h 


basic.h 


Standard 


Function 


network  set  exercise  id 


main  read  oars  file 


set  request  receive  size 


set  request  send  size 


set  assvmetric  on 


keyboard  use  cupola 


set  catc  mode 


imSEM 


network_dont_really_open_u 

ethernet 


network  set  exercise  id 


cfail  debuq  on 


CIO  not  usinq  qraphics 


rint  hel 


keyboard  really  use 


disable  status  printin 


V  pkt  verbose  mode 


vision  set  otw  niqht  vision 


et  default  db  name 


et  default  db  version 


rva  turn  debuq  on 


sound  dont  use 


network  set  network  device 


cig_use_database_override_ 

named 


isalpha 


set  ded  name 


terrain  verbose  mode  on 


set  ciq  dev 


set  ciq  mask 


Sim  state  startu 


simulation  state  machine 


Where 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Calls 


Described 


2.5.1.1.1 


2.1.1.3.1.49.1 


2.5.1. 2.1 


2.1.2.2.1.29.1 


2.1.2.2.1.30.1 


2.1.2.2.2.112.1 


2. 1.5.2 


2.2.6.4.3 


2.1.2.2.2.116.1 


2.1.1.3.2.14.1 


Section  2.1.1.3.1.49.1 


Section  2.5.4.2.1 


Section  2.1.2.2.1.5.1 


Section  2. 2. 1.1.1 


Section  2. 1.6.2 


Section  2.1. .1.3.1 .66.1 


Section  2.2.6.4.3 


Section  2.5.1.2.15 


Section  2.5.1.2.16 


Section  2.5.12.2.1 


Section  2. 1.3.2 


Section  2.1.1.3.2.12.4 


Section  2.1.2.2.1.16.1 


Section  2.1. .2.2.1 .8.2 


Section  2.5.11.9.1 


Section  2.1.2.2.1.26.1 


Section  2.1.2.2.2.114.1 


Section  2.5. 1.1 .5 


Section  2.5.1.1.13 


Table  2.2-8:  main  Information. 
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2.2.1.1.19  reconstitute_vehicle 

This  m^e  recomtitues  a  vehicle,  sending  an  activate  request  to  the  MCC. 


1  Calls  1 

Function 

Where  Described 

orocess  acti»rate  request 

2.1.1.3.2.1.1 

network  <$et  exercise  id 

2.1.1.3.1.16.1 

Table  2.2>9:  reconstitute  vehicle  Information. 
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2.2.2  Ml  Controls/Switchology 

A  large  portion  of  the  code  generated  for  specific  vehicles  exists  in  this  section.  Since  every 
vehicle  has  its  own  complement  of  differing  controls  and  indicators,  these  files  exist  in  vehicle 
specific  code.  The  structure  of  this  CSC  is  shown  in  Figure  2.2-4.  The  three  third  level 
CSC's  which  comprise  this  second  level  CSC  are  as  follows: 

Low  Level  Control  Handling 
Finite  State  Machines 
Specialized  Output  Devices 


M1  Controls  /  Switchology 
5.2.2 


Low  Level 
Control 
Handling 

5.2.2.  t 

Finite  State 
Machines 

5.2.2.2 

Specialized 

Output 

Devices 

5.2.2.3 

ml  ctl  npc.c 

5.2.2.1.1 

ml  ctl  fsm.c 

5.2.2.2.1 

m1_meter.c 

5.2^.3.1 

m1  ctl  mpc.c 

5.2.2.1.2 

ml  handles.c 

5.2.2.2.2 

m1_pots.c 

5.2.2.3.2 

m1  ctl  tpc.c 

5.2.2.1.3 

mijire  ctl.c 

5.2.2.2.3 

Figure  2.2-3;  Ml  Controls  /  Switchology  CSC  structure. 
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2.2.2. 1  Low  Level  Control  Handling 

Since  the  simulation  is  interested  in  transitions  of  a  control,  the  past  state  of  a  control  must  be 
maintained  and  updated  each  tick  of  the  simulation.  Therefore,  a  state  variable  is  defined  for 
each  control  in  a  vehicle  simulation.  The  controls  are  grouped  into  separate  files  based  on  the 
"power  state".  The  "power  state"  of  a  control  is  defin^  as  the  power  requirements  to  make  the 
control  active.  The  following  controls  are  examples: 

To  increase  efficiency,  the  past  state  of  a  control  is  only  maintained  when  a  control  is  active. 
The  last  three  letters  of  the  files  listed  below  are  the  initials  of  the  power  states: 

ti^:  master  power  controls 
npc:  no  power  controls 
t^:  turret  power  controls 
tnp:  turret  no  power 
hnp:  hull  no  power 
tdc:  turret  drive  controls 

The  CSU’s  that  are  associated  with  this  CSC  are  as  follows: 

ml_ctl_npc.c 

ml_ctl_mpc.c 

ml_ctl_tpc.c 

ml_pots.c 
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2. 3. 2. 1.1  inl_ctl  npc.c 

(/sininet^lease/src/vehicle/ml/src/ml_ctl_npc.c  [ml_ctl_npc.c]) 

This  CSU  provides  the  no  power  controls  interface  for  the  Ml  simulator.  No  power  is 
required  to  make  the  control  active.  This  module  uses  these  include  files: 


"stdio.h" 

"sim_dfns.h" 

"mass_stdc.h" 

"sim_cig_if.h" 

"Ubcig.h" 

"Ubidc.h" 

"Ubmem.h" 

"libnetwork.h" 

"timers.h" 

"ml_ammo.h" 

"m  l_ammo_mx.h" 

"ml_cntrl.h" 

"ml_cupola.h'' 

"ml_dtrain.h" 

"ml_comm_mx.h" 

"ml_hydrsys.h" 

"ml.pots.h" 

"ml_status.h" 

"ml_tnirs_df.h" 

"ml_turr_pn.h" 

"ml_vision.h" 


"sim_types.h" 

"sim_macros.h’’ 

"dgi.stdg.h" 

"dtad.h” 

"libidc_dfn.h’’ 

"libmem_dfn.h" 

"status.h" 

"timers_dfn.h" 

"m  1  _ammo_df .h” 

"ml_ammo_pn.h" 

"ml_ctl_df.h*’ 

"ml_driv_pn.h’’ 

"ml  _gunn_mx.  h" 

"ml_load_mx.h" 

"mljdc.h" 

"ml_repair.h" 

"ml_thermal.h" 

"ml_tracks.h" 

"ml_turret.h" 

"mun_type.h" 
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This  file  defines  the  following  variables: 


1  Variables  | 

Variables 

Tvpe 

Where  Typedef  Declared 

apds  translations 

ini  array 

Standard 

heat  translations 

int  array 

Standard 

select  translations 

int  array 

Standard 

turret  ref  translations 

int  array 

Standard 

real  service  brake  val 

REAL 

Sim  types.h 

real  comm  weao  val 

REAL 

Sim  types.h 

real  load  peri  val 

REAL 

sim  types.h 

hex  service  brake  val 

int 

Standard 

hex  comm  weap  val 

int 

Standard 

hex  load  peri  val 

int 

Standard 

Qps  map  val 

char 

Standard 

char 

Standard 

ejection  ouard  val 

char 

Standard 

ammo  transfer  status 

char 

Standard 

arid  azimuth  status 

char 

Standard 

fuel  flash  count 

int 

Standard 

fuel  flash  status 

char 

Standard 

odometer  timer  number 

int 

Standard 

cupola  UP  down  val 

char 

Standard 

binoculars  on  off  val 

char 

Standard 

Ipscope  UP  down  val 

char 

Standard 

thermal  shutter  val 

char 

Standard 

Table  2.2-10:  inl_ctl_npc.c  variables. 
This  file  defines  the  routines  listed  in  the  tables  below. 

Initialization  Routines: 


The  routines  listed  in  the  following  table  initialize  the  service  brake,  the  gunner's  primary  sight 
ma^ification,  the  ejection  guard,  the  ammunition  transfer  system,  the  commander’s  weapon 
station,  the  loader's  periscope,  the  cupola,  the  binoculars,  and  the  thermal  shutter. 


Name 

Type  of  Routine 

controls  npc  init  0 

void 

controls  service  brake  init  0 

void 

controls  maq  init  0 

void 

controls  ejection  quard  init  0 

void 

controls  ammo  transfer  init  {) 

void 

controls  commander  weapon  station  init  () 

void 

controls  loader  periscope  init  0 

void 

controls  cupola  up  down  init  0 

void 

controls  binoculars  on  off  init  () 

void 

controls  Ipscope  up  down  init  0 

void 

controls  thermal  shutter  init  () 

void 

Table  2.2-11:  Initialization  routines. 
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Status  Indicator  Check  Routines: 

These  routines  are  called  on  a  tick  by  tick  basis  to  check  the  status  of  the  parking  brake,  service 
brake,  ejection  guard,  breech,  ammunition  transfer  system,  knee  switch,  commander's  weapon 
station,  the  loader's  periscope,  the  fuel  controls,  odometer,  cupola,  binoculars,  and  thermal 
shutter. 


Name 

Type  of  Routine 

controls  oarkinq  brake  check  0 

void 

controls  service  brake  check  0 

void 

controls,  maq  check  0 

void 

controls  ejection  quard  check  () 

void 

controls  breech  check  () 

void 

controls  breech  unload  check  () 

void 

controls  breech  ready  check  () 

void 

controls  ammo  transfer  check  () 

void 

controls  knee  switch  check  0 

void 

controls  commander  weapon  station  checkO 

void 

controis  loader  periscope  check  () 

void 

controis  qrid  a2imuth  check  0 

void 

controis  fuel  flash  check  () 

void 

controls  odometer  check  () 

void 

controls  cupola  up  down  check  () 

void 

controls  binoculars  on  off  check  () 

void 

controls  Ipscope  up  down  check  () 

void 

Table  2.2-12:  Status  Indication  Check  Routines. 


Exit  Routines: 


These  routines  cause  an  orderly  exit  from  the  service  brake,  odometer,  cupola,  binoculars,  and 
loader's  periscope. 


Name 

Type  of  Routine 

controls  no  power  routines  0 

void 

controls  service  brake  exit  () 

void 

controls  odometer  exit  0 

void 

controls  cupola  up  down  exit  () 

void 

controls  binoculars  on  off  exit  0 

void 

controls  Ipscope  up  down  exit  () 

void 

controls  no  power  off  () 

void 

Table  2.2-13:  Exit  Routines. 
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Munitions  Management  Controls  Routines: 

These  routines  are  caJBed  internally  to  interface  with  the  switches  and  indicators  on  the  Ammo 
Redistribute  panel,  tEn:  Loader's  Panel,  the  ammo  tube,  the  breech,  the  Ammunition  Ready 
Rack,  and  the  fuel  redistribution  system. 


Name 

Type  of  Routine 

controls  transfer  semi  beat  0 

void 

controls  transfer  semi  atxls  0  . 

void 

controls  transfer  hull  heat  0 

void 

controls  transfer  hull  aods  0 

void 

controls  transfer  no  transfer  0 

void 

controls  transfer  redist  send  0 

void 

controls  transfer  redistt  recvO 

void 

controls  ejection  ouarcS  armed  0 

void 

controls  ejection  Quard  safe  0 

void 

controls  ammo  tube  dheck  () 

void 

controls  show  round  (1) 

void 

controls  unshow  round  0 

void 

controls  resupply  empt^y  () 

void 

controls  resupply  flash  0 

void 

controls  resupply  unflash  () 

void 

controls  resupply  restore  0 

void 

controls  show  breech  (1 

void 

controls  start  fuel  fladhinq  0 

void 

controls  stop  fuel  fladhinq  0 

void 

controls  restore  ammo  0 

void 

controls  fuel  flash  () 

void 

controls  fuel  unflash 

void 

controls  fuel  restore  (1 

void 

Tatile  2.2-14:  Munitions  Management  Routines. 
Miscellaneous  Routines: 


These  routines  are  called  internally  for  control  of  the  parking  brake,  control  of  the  turret 
reference  indicator,  arid  global  access  of  the  gunner’s  primary  sight  value. 


Name 

Type  of  Routine 

qet  non  thermal  maq  () 

char 

controls  set  parkinq  brake  () 

void 

controls  release  parkir^q  brake  () 

void 

controls  turret  ref  ind  i) 

void 

Table  2.2-15:  Miscellaneous  Routines. 
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2. 3. 2. 1.2  inl_ctl  mpc.c 

(/simnet^lease/src/vehicle/m  1/src/m  1  _ctl_mpc .c  [m  l_ctl_mpc.c] ) 

This  CSU  provides  the  master  power  controls  interface  for  the  Ml  simulator.  These  controls 
require  master  control  power  for  activation.  This  module  uses  these  include  files: 


"stdio.h" 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"timers  dfn.h" 

"timers.h" 

"libidc.h" 

"libidc  dfn.h" 

"libmem.h" 

"libmem_dfn.h" 

"libnetwork.h" 

"ml_cntrl.h" 

"ml_ctl_df.h" 

"ml_elecsys.h" 

"ml_engine.h" 

"ml_driv_mx.h" 

"ml_driv_pn.h" 

"ml_dtrain.h" 

"ml_fuelsys.h" 

"ml  hydrsys.h" 

"ml_meter.h" 

"ml_pots.h" 

"ml_turr_pn.h" 

This  file  defines  the  following  variables. 


1  Variables  I 

Variables 

Where  Typedef  Declared 

real  steer  bar  val 

REAL 

Sim  types. h 

real  throttle  val 

REAL 

sim  types. h 

hex  steer  bar  val 

int 

Standard 

hex  throttle  val 

int 

Standard 

driver  panel  test  val 

char 

Standard 

transmission  val 

char 

Standard 

tank  select  val 

char 

Standard 

tactical  idle  val 

char 

Standard 

push  to  start  val 

char 

Standard 

enaine  lamp  timer  number 

int 

Standard 

enaine  abort  timer  number 

int 

Standard 

radio  failure  status 

int 

Standard 

Table  2.2<16:  ml_ctl_mpc.c  variables. 
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This  ifUe  defines  the  routines  listed  in  the  tables  below. 

InitBalization  Routines: 


The  SDUtines  listed  in  the  following  table  initialize  the  controls  requiring  master  power:  steer 
bar,  tiftuottle,  transmission,  fuel  tank  selector,  engine  start  switch,  driver  panel  lights,  and 
tactical  idle  switch. 


Namce 

Type  of  Routine 

controls  moc  init  0 

void 

controls  master  power  on  0 

void 

controfis  steer  bar  init  0 

void 

controls  throttle  init  0 

void 

contrails  transmission  init  0 

void 

controls  tank  select  init  () 

void 

controls  enqine  start  init  () 

void 

controls  driver  panel  liqht  init  0 

void 

controls  tactical  idle  initO 

void 

Table  2.2-17:  Initialization  routines. 


Statius  Indication  Routines: 


These  routines  are  called  on  a  tick  by  tick  basis  to  check  the  status  of  the  steer  bar,  throttle, 
transmission,  fuel  tank  selector  switch,  driver  panel  lights,  engine  start  switch,  engine  shutoff 
switdh,  engine  lamp,  engine  tactical  idle  switch,  and  master  caution  lamps. 


Namie 

Type  of  Routine 

contnols  master  power  routines  () 

void 

controls  steer  bar  check  () 

void 

contrcDls  throttle  check  () 

void 

controls  transmission  check  () 

void 

controls  tank  select  check  () 

void 

controls  enqine  start  check  () 

void 

controls  enqine  shutoff  check  0 

void 

controls  enqine  lamp  check  () 

void 

controls  enqine  abort  check  () 

void 

controis  tactical  idle  check  () 

void 

controls,  caution  reset  check  () 

void 

contrrols  driver  panel  liqht  check  {) 

void 

Table  2.2-18:  Status  Indication  Routines. 
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Exit  Routines: 

These  routines  cause  an  orderly  exit  from  the  routines  listed  above. 


Name  and  Description 

Type  of  Routine 

controls  master  power  off  () 

void 

controls  steer  bar  exit  0 

void 

controls  throttle  exit  0 

void 

controls  enaine  lamp  exit  0 

void 

controls  enaine  abort  exit  0 

void 

controls  driver  panel  light  exit  () 

void 

Table  2.2-19:  Exit  Routines. 
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Miscellaneous  Routines: 

These  routines  are  used  internally  by  the  above  routines. 


Name  and  Descrlntlon 


controls  driver  panel  llaht  on 


controls  driver  panel  light  restore 


controls  master  power  edges  clear 


controls  driver  panel  status 


controls  engine  started 


controls  engine  spooling  down 


controls  engine  abort 


controls  engine  reset  abort 


controls  engine  overspeed 


controls  engine  overspeed  normal 


controls  low  fuel  on 


controls  low  fuel  off 


controls  low  charge  on 


controls  low  charge  off 


controls  engine  oil  level  low 


controls  engine  oil  level  normal 


controls  transmission  oil  level  low 


controls  transmission  oil  level  normal 


controls  engine  oil  filter  clogged 


controls  engine  oil  filter  normal 


controls  transmission  oil  filter  cl 


controls  transmission  oil  filter  normal 


controls  engine  fuel  filter  clogged 


controls  engine  fuel  filter  normal 


controls  right  oump  inoperative  on 


controls  right  pump  inoperative  off 


controls  left  Dump  inoperative  on 


controls  left  pump  inoperative  off 


controls  engine  oil  temperature  high 


controls  engine  oil  temperature  normal 


controls  engine  oil  pressure  low 


controls  engine  oil  pressure  normal 


controls  transmission  on  temperature  high 


controls_transmission_oil_temperature_normal 


n 


Type  of  Routine 


void 


void 


void 


int 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


void 


controls  transmission  oil  pressure  low 


controls  transmission  oil  pressure  normal 


controls  caution  lamp  off  check 


controls  warning  lamp  off  check 


controls  kill  radio 


Table  2.2-20:  Miscellaneous  Routines. 
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2. 3. 2. 1.2  inl_cti  tpc.c 

(/simnel;^lease/src/vehicle/ml/src/ml_ctl_tpc.c  [ml_ctl_tpc.c]) 

This  CSU  provides  the  turret  power  controls  interface  for  the  Ml  simulator.  These  controls 
require  turret  power  for  activation.  This  module  uses  these  include  files: 


'stdio.h" 

"sim_types.h" 

'sim_dfns.h" 

"sim_macros.h" 

'timers  dfn.h" 

"timers.h" 

'libidc.h" 

"libidc.dfn.h" 

’libmem.h" 

"libmem  dfn.h" 

'libnetwork.h" 

"ml  bcs.h" 

'ml_cntrl.h" 

"ml_ctl_df.h" 

ml  ammo  df.h" 

"ml_ammo.h" 

'ml_firecti.h" 

"ml_weapons.h" 

'ml_handles.h" 

"ml  laser.h" 

'ml_pots.h'' 

"ml_turret.h” 

'ml_comm_mx.h" 

"ml_gunn_mx.h’ 

'ml_load_mx.h" 

"ml_turr_pn.h" 

'ml_ammo_pn.h" 

"ml_thermal.h" 

This  file  defines  the  following  variables. 


1  Variables  | 

Variables 

Where  Tvpedef  Declared 

real  ounn  elev  val 

REAL 

Sim  types.h 

real  comm  elev  val 

REAL 

Sim  types.h 

real  qunn  trav  val 

REAL 

Sim  types.h 

real  comm  trav  val 

REAL 

sim  types.h 

hex  qunn  elev  val 

int 

sim  types.h 

hex  comm  elev  val 

int 

sim  types.h 

hex  qunn  trav  val 

int 

sim  types.h 

hex  comm  trav  val 

int 

sim  types.h 

commander  add  drop  val 

char 

sim  types.h 

commander  panel  test  val 

char 

sim  types.h 

ammo  select  val 

char 

sim  types.h 

fire  control  val 

char 

sim  types.h 

qun  drive  val 

char 

sim  types.h 

aun  select  val 

char 

sim  types.h 

qunner  palm  switch  val 

char 

sim  types.h 

commander  palm  switch  val 

char 

sim  types.h 

laser  select  val 

char 

sim  types.h 

qunner  palm  switch  val 

char 

sim  types.h 

commander  palm  switch  val 

char 

sim  types.h 

laser  select  val 

char 

sim  types.h 

qunner  laser  button  val 

char 

sim  types.h 

commander  laser  button  val 

char 

sim  types.h 

thermal  mode  val 

char 

sim  types.h 

themial  polarity  val 

char 

sim  types.h 

thermal  maqnitude  val 

char 

sim  types.h 

Table  2.2-21:  ml_ctl_tpc.c  variables. 
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This  file  defines  the  routines  listed  in  the  tables  below. 

Initialization  Routines: 

The  routines  listed  in  the  following  table  initialize  the  gunner's  and  commander's  palm 
switches,  the  gunner's  and  commander's  gun  elevation  handles,  the  gunner's  and 
commander's  gun  traverse  handles,  the  gunner's  and  commander's  laser  buttons,  the  bcs 
manual  range  drop  button,  the  commander's  panel  lights,  the  fire  control  gun  drive  control,  the 
gun  selector,  the  ammo  selector,  the  thermal  mode  control,  the  thermal  polarity  control,  and  the 
diermal  magnitude  control. 


Name  and  Description 

Type  of  Routine 

controls  palm  switch  init  0 

void 

controls  oun  elevation  init  () 

void 

controls  qun  traverse  init  () 

void 

controls  laser  select  init  () 

void 

controls  add  drop  init  0 

void 

controls  firecti  aundrive  init  () 

void 

controis  qun  select  init  () 

void 

controls  ammo  select  init  0 

void 

controls  commander  panel  liqht  init  () 

void 

controls  thermal  mode  init  0 

void 

controls  thermal  polarity  init  0 

void 

controisjhermal  maqnitude  init  0 

void 

Table  2.2>22:  Initialization  routines. 


Miscellaneous  Status  Indicator  Routines: 

These  routines  are  called  on  a  tick  by  tick  basis  to  check  the  status  of  the  controls  initialized  in 
the  table  above. 


Name  and  Description 

Type  of  Routine 

controls  palm  switch  check  () 

void 

controls  qun  elevation  check  () 

void 

controls  qun  traverse  check  () 

void 

controls  laser  fired  check  () 

void 

controls  laser  select  check  () 

void 

controls  triqqer  check  () 

void 

controls  .battlesiqht  check  () 

void 

controls  add  drop  check  () 

void 

controls  firecti  qundrive  check  0 

void 

controls  qun  select  check  () 

void 

controls__ammo  select  check  {) 

void 

controls  commander  panel  liqht  check  () 

void 

controls  thermal  mode  check  () 

void 

^mmmnsstrsEsmjSssstmmmm 

void 

1  controls  thermal  maqnitude  check  () 

void 

Table  2.2-23:  Check  Routines. 
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Exit  Routines: 

These  routines  cause  an  orderly  exit  from  the  routines  listed  above. 


Name  and  Description 

Type  of  Routine 

controls  palm  switch  exit  0 

void 

controls  aun  elevation  exit  0 

void 

controls  aun  traverse  exit  0 

void 

controls  add  drop  exit  0 

void 

controls  commander  panel  liqht  exit  () 

void 

controls  thermal  mode  exit  0 

void 

controls  thermal  polarity  exit  0 

void 

controls  thermal  maanitude  exit  () 

void 

Table  2.2-24; 

Exit  Routines. 

Miscellaneous  Routines: 

These  routines  are  used  internally  by  the  above  routines. 

Name  and  Description 

Type  of  Routine 

controls  turret  power  off  0 

void 

controls  aun  fired  f) 

void 

controls  laser  malfunction  set  0 

void 

controls  laser  malfunction  reset  0 

void 

controls  thermal  ready  liqht  on  () 

void 

controls  thermal  ready  liqht  off  0 

void 

controls  firecti  qundrive  fsm  () 

void 

controls  qun  select  fsm  () 

void 

controls  commander  panel  liqht  on  () 

void 

controls  commander  panel  liqht  restore  () 

void 

controls  commander  fake  liqht  on  () 

void 

controls  commander  fake  liqht  restore  () 

void 

Table  2.2<25:  Miscellaneous  Routines. 
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2. 2. 2. 2  Finite  State  Machines 

In  goneral,  finite  state  machines  describe  the  appropriate  actions  to  take  when  a  control  changes 
value..  The  following  are  examples  of  the  type  of  functions  that  are  contained  in  the  files  listed 
below; 

tt)  When  the  driver  of  an  m2  tank  presses  the 
accelerator,  the  simulation  must  first  discern  the 
states  of  the  engine,  transmission,  emergency  brake, 
etc.  before  the  action's  effect  can  be  (fetermined 

S)  When  the  ^ner  on  an  ml  tank  pulls  the  trigger, 
the  simulation  must  first  check  the  states  of  the 
gunners  palm  grip,  commanders  palm  grip,  the  weapon 
loaded,  etc.  before  determining  the  necessary  actions 
resulting  from  the  trigger  pull. 

The  CSU’s  associated  with  this  CSC  are  as  follows: 

ml_ctl_fsm.c 

ml_handles.c 

ml_firectl.c 


2. 2. 2. 2.1  ml_ctl  fsm.c 

(./simne^release/src/vehicle/m  1/src/m  1  _ctl_fsm.c  [m  1  _ctl_fsm.c] ) 

The  CSU  ml_ctl_fsm.c  maintains  the  "power  state"  which  is  defined  in  section  2.2.2. 1.  This 
CSU  prides  the  finite  power  state  controls  interface  for  the  Ml  simulator.  This  module  uses 
these  hnclude  files: 


"stdio.h" 

"sim_dfns.h" 

"Ubidc.dfn.h" 

"libmem_dfn.h" 

"ml_ammo.h" 

"ml_ctl_df.h" 

"ml_engine.h" 

"ml_turr_pn.h" 


"sim_types.h" 

"libidc.h" 

"libmem.h" 

"libnetwork.h" 

"ml.cntrl.h" 

"ml_elecsys.h" 

"ml_driv_pn.h" 

"ml_ammo_pn.h" 


This  file  defines  the  following  variables; 


1  Variables  I 

Varla:^les 

Type 

Where  Typedef  Declared 

contro  ls  status 

int 

Standard 

controfts  electsys  val 

int 

Standard 

controls  electsys  off  edge 

int 

Standard 

controls  failure  val 

int 

Standard 

controls  failure  edge 

int 

Standard 

Table  2.1-21:  ml  ctl  fsm.c  variables. 


470 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


Simulation  Routines: 

The  controls_simulO  routine  contains  the  fine  state  machine  simulation,  called  on  a  tick  by 
tick  basis.  Tlie  other  routines  handle  the  transitions  between  states  in  the  master  power,  no 
power,  and  turret  power  conditions.  If  a  no  power  state  is  detected,  then  the  controls  are  set  to 
specified  initial  v^ues  which  are  usually  defined  as  an  OFF  state. 


iName  and  Description 

Type  of  Routine 

I>>1 1 1 1 M  M 1  >■  ■  1 

void 

controls  master  power  next  state  0 

void 

controls  turret  power  next  state  0 

void 

controls  simulO 

void 

Table  2.2*28:  Simulation  Routines. 


Initialization  Routines: 


These  routines  initialize  the  finite  state  machine,  the  edges,  and  the  IDC  outputs. 


Name  and  Description 

Type  of  Routine 

controls  fsm.  init  0 

void 

controls  edqe  init  () 

void 

controls  lamp  initO 

void 

Table  2.2*29:  Initialization  routines. 


Miscellaneous  Routines: 


The  following  routines  used  internally  by  the  above  routines. 


Name  and  Description 

Type  of  Routine 

controls  power  status!) 

void 

controls  electsvs  dead  0 

void 

controls  electsvs  reborn  () 

void 

controls  electsvs  status  0 

int 

controls  break  controls  0 

void 

controls  restore  controls  () 

void 

controls  failure  status!) 

int 

controls  other  edaes  clear !) 

void 

Table  2.2*30:  Miscellaneous  Routines. 
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2. 2. 2. 2. 2  inl_handles.c 

(./sininet/release/src/vehicle/ml/src/ml_han(iles,c  [ml_handles.c]) 

The  CSU  ml_handles.c  contains  state  machines  that  keep  track  of  the  gunners  and 

commanders  palm  grips,  and  the  associated  control  of  the  respective  turrets. 

Includes: 

"sim_types.h" 

"sim_dfns.h" 

"UbfaiLh" 

"faUure.h" 

"ml_bcs.h" 

"ml_weapons.h" 

"mljaser.h" 

"ml_turret.h" 

int  variable  declarations: 

gunner_control_status 
cmdr_control_status 
gunner_control_engaged 

cmdr_control_engaged 
gunner_trigger_pushed 
cmdr_trigger_pushed 


gunner_laser_pushed 


cmdr_laser_pushed 
use_dazzler_laser 

REAL  variable  declarations:  —  normalized  values  from  - 1 .0  to  + 1 .0  which  are 

received  directly  from  controls  and  passed  to  the 
turret  if  the  appropriate  palm  switch  is  engaged 

gunner_tra  verse 
cmdr_traverse 
gunner_elevate 
cmdr_elevate 


“  maintenance  status:  normally  WORKING 

-  booleans  which  tell  whether  palm  switches  are 
engaged 

--  either  TRUE  or  FALSE 

-  These  are  both  edge-triggered  rather  than  level- 
triggered,  so  they  are  cleared  immediately  after 
use. 

-  either  CLEAR,  PUSHED,  or  USED.  These  are 
both  level- triggered.  A  stock  Ml  treats  them  as 
edges. 


Defines: 

Symbol 

CLEAR 

PUSHED 

USED 


Value 

0 

1 

2 
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2. 2. 2. 2. 2.1  handles_siinul 

This  routine  simulates  the  commander's  controls  on  a  tick  by  tick  basis.  It  checks  to  see  if 
handles  are  working  and  which  handles  are  engaged. 


1  Calls  1 

Function 

Where  Described 

laser  lase 

Section  2.2.3.2.15 

turret  handles  values 

Section  2.2.6.1.1.6 

weapons  fire  main  aun 

Section  2.2.3.3.6 

Table  2.2*31:  handles  simul  Information. 


2 . 2 . 2 . 2 . 2 . 2  ban  dles_gunner_con  trol_fixed 

This  routine  repairs  the  gunner's  control. 


2 . 2 . 2 . 2 . 2 . 3  handles_gunner_cont  r  oI_broken 

This  routine  causes  the  gunner's  control  to  fail. 


2 . 2 . 2 . 2 . 2 . 4  handles_comman  der_control_fi  xed 

This  routine  repairs  the  commander's  control. 


2. 2. 2. 2. 2. 5  handles_commander_control_broken 

This  routine  causes  the  commander's  control  to  fail. 


2. 2. 2. 2. 2. 6  handles_gunner_palm_on 

This  routine  engages  the  gunner's  control. 


2. 2. 2. 2. 2. 7  handles_gunner_paIm_off 

This  routine  disengages  the  gunner’s  palm  switch.  It  is  called  by  the  controls  module  when  the 
gunner's  palm  switch  is  released,  or  when  turret  power  is  turned  off  while  the  gunner’s  palm 
switch  is  engaged. 


2 . 2 . 2 . 2 . 2 . 8  handles_commander_paim_on 

This  routine  engages  the  commander's  palm  switch. 
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2 . 2 . 2 . 2 . 2 . 9  handIes_commander_palin_off 

This  routine  disengages  the  commander's  palm  switch.  It  is  called  by  the  controls  module 
when  the  commander’s  palm  switch  is  released,  or  when  turret  power  is  turned  off  while  the 
commander's  palm  switch  is  engaged. 


2.2.2.2.2.10  handles_set_gunner_elevation 

This  routine  sets  the  gunner's  elevation  rate  to  elevation  rate. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

elevation  rate 

reaister  REAL 

Sim  types. h 

Table  2.2*32:  handles_set_gunner_elevation  Information. 


2.2.2.2.2.11  handles_set_commander_elevation 

This  routine  sets  the  commander's  elevation  rate  to  elevationjrate. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

elevation  rate 

reqister  REAL 

simJvpes.h 

Table  2.2-33:  handles_set_commander_elevation  Information. 


2.2.2.2.2.12  handles_set_gunner_traverse 

This  routine  sets  the  gunner's  traverse  rate  to  traverse  rate. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

traverse  rate 

register  REAL 

Sim  types. h 

Table  2.2-34:  handles_set_gunner_traverse  Information. 


2.2.2.2.2.13  handles_set_commander_traverse 

This  routine  sets  the  commander's  traverse  rate  to  traverse  rate. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

traverse  rate 

reaister  REAL 

sim_types.h 

Table  2.2-35:  handles  set  commander  traverse  Information. 
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2.2.2.2.2.14  handles_gunner_laser_button_relfc..sed 

This  routine  is  not  used  in  the  version  6.6  release. 

2.2.2.2.2.15  handies_gunner Jaser_button_depressed 

This  routine  sets  gunner_laser_pushed  equal  to  PUSHED  when  the  gunner's  laser  button  is 
depressed. 

2.2.2.2.2.16  handles_coinmander_laser_button_released 

This  routine  sets  cmdr_laser_pushed  equal  to  CLEAR  when  the  commander's  laser  button  is 
released. 

2.2.2.2.2.17  handles  commander_laser_button_depressed 

This  routine  sets  cmdr_laser_pushed  equal  to  PUSHED  when  the  commander's  laser  button  is 
depressed. 

2.2.2.2.2.18  handles_gunner_trigger_depressed 

This  routine  sets  gunner_trigger_pushed  equal  to  TRUE  when  the  gunner's  trigger  is 
depressed. 

2.2.2.2.2.19  handles_commander_trigger_depressed 

This  routine  sets  cmdr_trigger_pushed  equal  to  TRUE  when  the  commander's  trigger  is 
depressed. 

2.2.2.2.2.20  ha ndles_gunner_t rigger_released 
This  routine  is  not  used  in  the  version  6.6  release. 

2.2.2.2.2.21  handles_commander_trigger_release  J 
This  routine  is  not  used  in  the  version  6.6  release. 
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2.2.2.2.2.22  handles_init 

This  routine  initializes  the  handles. 


1  Calls  1 

Function 

Where  Described 

fail  init  failure 

Section  2.5.4.11.2 

Table  2.2-36:  handies  init  Information. 


476 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


2. 2. 2. 2. 3  inl_firectl.c 

(./simnet/release/src/vehicle/ml/src/ml_firectl.c  [ml_firectl.c]) 

The  CSU  inl_firectl.c  computes  the  states  important  to  firing  weapons. 

Includes: 

"sim_types.h" 

"sim_(tfns.h" 

"ml_gunn_mx.h" 

"ml_load_mx.h" 

"ml_ctl_df.h" 

"ml_cntrl.h" 

"ml_firecU.h" 

"ml_laser.h" 

"ml_ammo.h" 

int  variable  declarations: 
gun_selected 
fire_control_mode 
gun_drive_val 

BOOLEAN  variable  declarations: 
malfunction_val 


2. 2. 2. 2. 3.1  firectljnit 

This  routine  initializes  the  fire  control  state  variables  gun_selected,  fire_controLmode, 
gun_drive_val,  and  malfunction_val. 


2. 2. 2. 2. 3. 2  firectlmalfunction 

This  routine  returns  the  fire  control  malfunction  state. 


1  Return  Values  I 

Return  Value 

Type 

Meanina 

malfunction_val 

BOOLEAN 

The  fire  control  malfunction 
state 

Table  2.2-37:  firecti  malfunction  Information. 
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2. 2. 2. 2. 3. 3  fi  rectI_laser_malfunction_set 

This  routine  sets  the  fire  control  malfunction  state. 


1  Calls  1 

Function 

Where  Described 

controlsJaser_malfunction_s 

et 

Section  2.2.2 

Table  2.2-38:  firectI_laser_^malfunction_set  Information. 
2. 2. 2. 2. 3. 4  fi  rectl_Iaser_malfunction_reset 

This  routine  clears  the  fire  control  malfunction  state. 


_ _ Calls 

Function  Where  Described 

controls_laser_malfunction_re  Section  2.2.2 
set _ _ 


Table  2.2-39:  firectl_laser_maIfunction_reset  Information. 
2. 2. 2. 2. 3. 5  firectl_ready_to_fire 


This  routine  returns  the  fire  control  ready  status.  The  fire  control  system  is  ready  if  the 
ammunition  module  is  ready  to  fire,  the  turret  power  is  on,  the  main  gun  is  selected,  the  fire 
control  system  is  not  in  manual  mode,  and  the  gun  drive  state  is  powered. 


Return  Values  I 

Return  Value 

Type 

Meaning 

(ammo  ready  to  fire()) 

&& 

(controls_power  status()  == 
CONTROLS  STATE  TURRE 
T  POWER  ON) 

&& 

(gun  selected  == 
GN_MAIN_VAL) 

&& 

(fire  control  mode  != 

GN  MANUAL  VAL) 

&& 

(gun  drive  val  == 

LD  POWERED  VAL) 

BOOLEAN 

If  TRUE,  the  fire  control 
system  is  ready; 

If  FALSE,  the  fire  control 
system  is  not  ready. 

Calls 

Function 

Where  Described 

ammo  ready  to  fire 

Section  2,2.5.1.32 

controls  power  status 

Section  2  2.2 

Table  2,2-40:  fircctl  ready  to  fire  Information. 
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2. 2. 2. 2. 3. 6  firectl_gun_select_main 

This  routine  sets  the  gun  select  state  to  main. 

2. 2. 2. 2. 3. 7  firectl_gun_select_safe 

This  routine  sets  the  gun  select  state  to  safe. 

2. 2. 2. 2. 3. 8  fi  rectl_gun_select_coax 

This  routine  sets  the  gun  select  state  to  coaxial. 


2. 2. 2. 2. 3. 9  firectl_gun_select_status 
This  routine  returns  the  gun  select  state. 


1  Return  Values  I 

Return  Value 

Meanina 

Qun  selected 

int 

The  qun  select  state 

Table  2.2-41:  firectl_gun_select_status  Information. 


2.2.2.2.3.10  firectI_fire_controI_normal 

This  routine  sets  the  fire  control  mode  to  normal. 

2. 2. 2. 2. 3. 1 1  firectI_fire_control_emergency 

This  routine  sets  the  fire  control  mode  to  emergency. 

2.2.2.2.3.12  rirectl_fire_controI_manuaI 

This  routine  sets  the  fire  control  mode  to  manual. 

2.2.2.2.3.13  firectl_fire_cont rol_status 

This  routine  returns  the  fire  control  mode. 


1  Return  Values  1 

Return  Value 

fire  control  mode 

int 

The  fire  control  mode  I 

Table  2.2-42:  firecti  fire  control  status  Information. 
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Z.  2 . 2 . 2 . 3 . 1 4  fi  rectl_gun_dri ve_manual 
Tbis  routine  sets  the  gun  drive  state  to  manual. 


2.2.2.2.3.15  fi rectl_gun_dri ve_po wered 

TBiis  routine  sets  the  gun  drive  state  to  powered. 

2.2.2.2.3.16  firectl_gun_drive_uncpl 

Tfcus  routine  sets  the  gun  drive  state  to  uncoupled. 


2.2.2.2.3.17  firectl_gun_drive_status 
Tfais  routine  returns  the  gun  drive  state. 


1  Return  Values  1 

Return  Value 

Meaning 

ouin  drive  vaf 

int 

The  gun  drive  state 

Table  2.2*43:  firectl_gun_drive_status  Information. 
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2. 2. 2. 3  Specialized  Output  Devices 

As  stated  in  section  2.1,  the  output  devices  for  a  simulation  are  often  vehicle  specific.  The  files 
listed  below  contain  routine  which  compute  values  to  be  displayed  to  the  operator.  The  new 
values  are  sent  to  the  low  level  control  routines  (see  2.1.4).  This  functionality  is  realized  by 
two  CSU’s,  ml_meter.c  and  ml_pots.c. 


2. 2. 2. 3.1  ml_meter.c 

(./simnet^Iease/src/vehicle/ml/src/ml_meter.c  [ml_meter.c]) 

This  CSU  provides  routines  which  simulate  meters  on  the  Ml. 

Includes; 

"sim_types.h" 

"sim_(h'ns.h" 

■’ml_mtr_df.h" 

"ml_ctl_df.h" 

"ml.fueLdf.h" 

"ml_driv_pn.h" 

"ml_meter.h" 

"ml.cntrl.h" 

char  declarations: 

speed_set_val 

tach_set_val 

fuel_set_val 

volt_set_val 

REAL  variable  declarations  and  initialization: 
fueLfull  =  REAR_FUEL_FULL 


2. 2. 2. 3. 1.1  meter_init 

This  routine  initializes  the  four  meter  outputs:  speedometer,  tachometer,  fuel  guage,  and 
voltmeter. 
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2. 2. 2. 3. 1.2  meter_speed_set 

This  routine  sets  the  reading  on  the  speedometer  to  val,  the  input  value. 


Parameter 


val 


Internal  Variable 


tempi 


temD2 


\wm 


e 


REAL 


Parameters 


where  Typedef  Declared 


Sim  tvDes.h 


IE2T: 


Internal  Variables 


Function 


controls  power  status 


controls  electsvs  status 


controls  failure  status 


idc  output  set 


Calls 


Where  Described 


Section  2.2.2 


Section  2.2.2 


Section  2.2.2 


Section  2. 1.4. 1.1 


Where  Typedef  Declared 


Standard 


Standard 


Table  2.2-44;  meter_speed_set  Information. 


2. 2. 2. 3. 1.3  meter_tach_set 

This  routine  sets  the  value  on  the  tachometer  based  on  the  value  of  val. 


Parameters 


Parameter 


vai 


Internal  Variable 


tempi 


temp2 


Function 


controls  power  status 


controls  electsvs  status 


controls  failure  status 


idc  output  set 


e 


REAL 


Where  Typedef  Declared 


Sim  types. h 


Internal  Variables 


Calls 


Where  Described 


Section  2.2.2 


Section  2.2.2 


Section  2.2.2 


Section  2.1. 4.1.1 


Where  Typedef  Declared 


Standard 


Standard 


Table  2.2-45:  meter  tach  set  Information. 
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2. 2. 2. 3. 1.4  meter_fuel_set 

This  routine  sets  the  output  on  the  fuel  guage  based  on  the  value  of  val. 


1  Parameters  1 

1  Parameter 

Where  Typedef  Declared 

Ival 

REAL 

Sim  types. h 

1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

tempi 

char 

Standard 

temp2 

int 

Standard 

i  Calls  1 

Function 

Where  Described 

controls  power  status 

Section  2.2.2 

controls  electsvs  status 

Section  2.2.2 

controls  failure  status 

Section  2.2.2 

idc  output  set 

Section  2. 1.4.1 

Table  2.2-46:  meter  fuel  set  Information. 


2. 2. 2. 3. 1.5  meter_volt_set 

This  routine  sets  the  value  on  the  voltmeter  based  on  the  value  of  val. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

val 

REAL 

Sim  types. h 

Internal  Variables 

Internal  Variable 

Type 

Where  Typedef  Declared 

tempi 

char 

Standard 

temp2 

int 

Standard 

Calls 

Function 

Where  Described 

controls  power  status 

Section  2.2.2 

controls  electsvs  status 

Section  2.2.2 

controls  failure  status 

Section  2.2.2 

idc  output  set 

Section  2. 1.4.1 

Table  2.2-47:  meter  volt  set  Information. 


2 . 2 . 2 . 3 . 1 . 6  meter_select_front_left_tank 

This  routine  selects  the  left  front  fuel  tank. 
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2 . 2 . 2 . 3 . 1 . 7  meter_select_f  ront_right_tank 
This  routine  selects  the  right  front  fuel  tank. 

2 . 2. 2 . 3 . 1 . 8  meter_select_rear_tank 

This  routine  selects  the  left  front  fuel  tank. 
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2. 2. 2. 3. 2  inl_pots.c 

(./simnet/release/src/vehicle/ml/src/nil_pots.c  [ml_pots.c]) 

This  file  contains  the  procedures  relating  to  the  potentiometers,  which  translate  hex 
potentiometer  values  between  00  and  FF  into  real  numbers  and  call  the  appropriate  Ml 
subsystems  with  those  real  values. 

Includes: 

"stdio.h” 

"sim_types.h" 

"sim_dfns.h" 

"sim_macros.h" 

"libidc_dfn.h" 

"libnetwork.h" 

"ml_pots_df.h" 

"ml.calLdf.h" 

"libpots.h" 


The  following  functions  are  defined  for  the  Butterfly: 

FOPEN 

FCLOSE 

FSCANFl 

FSCANF2 

The  following  variables  represent  the  calibrated  hex  values  corresponding  to  the  pot  extremes, 
i.e.,  cm_tur_trav_l  is  the  hex  value  of  the  commanders  turret  traverse  handle  when  it  is  at  the 
full  left  position.  These  values  are  used  to  convert  hex  pot  values  to  real  numbers. 

The  commander's  turret  traverse:  left,  right,  centered: 
cm_tur_trav_l 
cm_tur_trav_r 
cm_tur_trav_c 

The  commander's  turret  elevate:  depress,  raise,  centered: 
cm_tur_elev_d 
cm_tur_elev_r 
cm_tur_elev_c 
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The  gunner’s  tturret  traverse:  left,  right,  centered: 
gn_tur_trav_l 


gn_tur_trav_r 

gn_tur_trav_c 


The  gunner’s  tiurret  elevate:  depress,  raise,  centered: 
gn_tur_elev_d 
gn_tur_elev_r 
gn_tuir_elev_c 

The  driver's  steering  bar:  left,  right,  centered: 
dr_steG5r_l 
dr_steer_r 
dr_stBer_c 

The  driver’s  tftirottle:  zero,  full: 
dr_thro)tde_z 
dr_tlm3ttle_f 


The  driver’s  service  brake:  zero,  full: 
dr_s_ferake_z 
dr_s_Bbrake_f 


The  commantfer’s  weapon  station:  left,  right: 
cm_cws;_l 
cm_cw.'s_r 


The  loader’s  periscope:  left,  right: 
ld_pei:ti_l 
ld_paS:_r 


2. 2. 2. 3. 2.1  pots_init 

This  routine  ircitializes  the  potentiometers.  The  calibration  file  is  opened,  and  the 
potentiometer  variables  are  assigned  values. 


1  Internal  Variables  | 

Internal  Variable 

Type 

Where  Typedef  Declared 

pots 

pointer  to  FILE 

line 

int 

Standard 

pots  error 

int 

Standard 

Calls 

Function 

Where  Described 

pots  check  thvree 

Section  2.1.4.1.2  6.1 

pots  check  two 

Section  2. 1.4.1. 2.1.1 

Table  2.2-48:  pots_init  Information. 
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2. 2. 2. 3. 2. 2  pots_comm_trav_real 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+1.0  for  the  commander's  turret  traverse  control. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

pot 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

pots_scaleJcr  (pot, 
cmjurjravj.  cm_tur_lrav_c, 
cm  tur  trav  r, 

COMM  TRAV  TOLERANCE) 

REAL 

The  scaled  value  of  the 
commander’s  turret  traverse 
control 

1  Calls  1 

Function 

Where  Described 

pots  scale  Icr 

Section  2. 1.4.1 .2.2.1 

Table  2.2-49;  pots_comm_trav_reaI  Information. 


2. 2. 2. 3. 2. 3  pots_comm_elev_^reaI 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+1.0  for  the  commander's  elevation  control. 


1  Parameters  | 

1  Parameter 

Type 

Where  Typedef  Declared 

o 

Q 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

pots_scaleJcr  (pot, 
cm_tur_elev_r, 
cm_tur_elev_c, 
cm  tur  elev  d, 

COMM  ELEV  TOLERANCE) 

REAL 

The  scaled  value  of  the 
commander's  elevation  control 

Calls 

Function 

Where  Described 

pots  scale  Icr 

Section  2. 1.4.1. 2.2.1 

Table  2.2-50:  pots_comm_elev_real  Information. 
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2. 2. 2. 3. 2. 4  pots_gunn_trav_real 


Given  th  e  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+1.0  for  the  gunner's  turret  traverse  control. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

Da»t 

int 

Standard 

Return  Values 

Return  Value 

Meaning 

pcs|s_scalejcr  (pot. 
gt»_tur_travj,  gn_tur_trav_c, 
gn  tur  trav  r, 

GUNN  TRAV  TOLERANCE) 

REAL 

The  scaled  value  of  the 
gunner’s  turret  traverse 
control 

1  Calls  I 

Function 

Where  Described 

perns  scale  Icr 

Section  2. 1.4.1. 2.2.1 

Table  2.2-51:  pots_gunn_trav_reaI  Information. 


2..  2. 2. 3. 2. 5  pots_gunn_elev_real 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+  1.0  for  the  gunner's  elevation  control. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

pot 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

pots_scaleJcr  (pot. 
gn_tur_elev_r. 
gn_tur_elev_c. 
gn  tur  elev  d. 

GUNN  ELEV  TOLERANCE)) 

REAL 

The  scaled  value  of  the 
gunner’s  elevation  control 

Calls 

Ft^jnctlon 

Where  Described 

prots  scale  Icr 

Section  2. 1.4.1. 2.2.1 

Table  2.2-52:  pots_gunn_elev_real  Information. 
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2. 2. 2. 3. 2. 6  pots_steer_bar_reaI 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
-t-1.0  for  the  driver's  steering  bar. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

pot 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

pots_scale_lcr  (pot, 
dr_steer_l,  dr_steer_c, 
dr  steer  r, 

STEER  TOLERANCE) 

REAL 

The  scaled  value  of  the 
driver’s  steering  bar 

1  Calls  1 

Function 

Where  Described 

pots  scale  Icr 

Section  2. 1.4.1. 2.2.1 

Table  2.2-53:  pots_steer_bar_reaI  Information. 

2. 2. 2. 3. 2. 7  pots_throttle_real 

Given  the  potentiometer  value  pots,  this  routine  returns  a  scaled  real  value  between  0.0  and 
-hl.O  for  the  driver's  throttle. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

pot 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

pots_scale_lrj3os  (pot, 
dr  throttle  z,  dr  throttle  f) 

REAL 

The  scaled  value  of  the 
driver's  throttle 

Calls 

Function 

Where  Described 

pots  scale  Ir  pos 

Section  2. 1.4.1. 2.4.1 

Table  2.2-54:  pots_throttle_real  Information. 
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2.2.2. 2 . 8  pots_service_brake_real 

Given  thcipotentiometer  value  pots,  this  routine  returns  a  scaled  real  value  between  0.0  and 
+1.0  for  tine  driver's  service  brake. 


1  Parameters  | 

Paramet&r 

Type 

Where  Typedef  Declared 

pot 

int 

Standard 

Return  Values 

Return  W^lue 

Type 

Meaning 

pots_scale_lr_pos  (pot. 
dr  s  brake  2,  dr  s  brake  f) 

REAL 

The  scaled  value  of  the 
driver's  service  brake 

Calls 

Function: 

Where  Described 

pots  scale  Ir  pos 

Section  2.1. 4.1. 2.4.1 

Table  2.2-55:  pots_service_brake_reaI  Information. 


2 . 2 . 2 . 3 . 2 . 9  pots_comm_wea  preal 


Given  the  ipotentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+1.0  for  dhe  commander's  weapons  control. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

pot 

int 

Standard 

Return  Values 

Return  V'alue 

Type 

Meaning 

pots_scaleJr_both  (pot, 
cm  cws  I,  vcm  cws  r) 

REAL 

The  scaled  value  of  the 
commander’s  weapons  control 

Calls 

Function 

Where  Described 

pots  scale  Ir  pos 

Section  2. 1.4.1. 2.4.1 

Table  2.2-56:  pots  comm  weap  real  Information. 
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2.2.2.3.2.10  pots_load_peri_real 

Given  the  potentiometer  value  pot,  this  routine  returns  a  scaled  real  value  between  -1.0  and 
+1.0  for  the  loader's  periscope  control. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

pot 

int 

Standard 

Return  Values 

Return  Value 

Type 

Meaning 

pots_scale_lr_both  (pot, 

Id  peri  1.  Id  peri  r) 

REAL 

The  scaled  value  of  the 
loader's  periscope  control 

1  Calls  1 

Function 

Where  Described 

pots  scale  Ir  pos 

Section  2. 1.4. 1.2. 4.1 

Table  2.2-57: 


pots_load_peri_real  Information. 
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2.2.3  Ml  Weapons 

The  Ml  fires  unguided,  or  ballistic,  rounds  The  simulation  must  model  the  processes 
associated  with  die  weapons  systems  which  take  place  within  the  vehicle.  It  dso  must  model 
the  flyout  of  the  round  and  the  reaction  to  impacts. 


Figure  2.2-4:  Structure  of  the  Ml  Weapons  CSC. 

The  Ml  accounts  for  the  ballistic  trajectory  of  the  rounds  fired  in  ballistic  computer  systems. 
These  systems  take  range  to  target  and  turret  traverse  rate  information  and  knowledge  about  the 
round  to  be  fired  in  order  to  calculate  superelevation  and  lead  angles. 

The  principle  means  of  obtaining  range  information  on  the  Ml  is  via  the  laser  range  finder. 
Ml_laser.c  models  the  laser  system.  It  responds  to  commands  from  the  controls  and  sends 
range  information  to  the  ballistics  computer.  The  modes  of  operation  of  the  system  are 
modeled  as  are  failure  modes  and  multiple  return  conditions. 

Calculation  of  the  superelevation  and  lead  angles  take  place  in  ml_bcs.c.  The  Ml  uses  range 
information  provided  by  the  laser  or  uses  the  range  set  by  the  user.  The  simulation  of  manual 
range  setting  is  performed  in  ml_bcs.c.  This  routine  tells  the  CIG  the  current  range  so  the 
range  can  be  displayed.  Knowledge  of  the  round  to  be  fired  is  also  maintained  in  ml_bcs.c  . 

Commands  to  fire  a  ballistic  round  are  initiated  in  the  controls  code.  There  are  a  number  of 
steps  to  be  performed  when  a  round  is  fired  and  these  tasks  are  performed  in  ml_weapons.c. 
The  availability  of  the  round  is  checked  by  polling  the  munitions  management  code.  If  a  round 
is  available,  the  direction  of  the  gun  tube  is  determined.  This  is  based  on  a  combination  of  the 
gunner's  line  of  sight,  the  superelevation  and  lead  angle  determined  in  the  ballistics  computer, 
and  a  random  offset  to  model  dispersion.  The  dispersion  is  found  using  routines  in  the  math 
library.  Libball  is  called  to  actually  fire  the  round.  If  the  round  is  successfully  fired,  the  sound 
of  firing  is  made,  the  ammunition  is  decremented  and  a  message  is  put  onto  the  net. 

Some  vehicle  specific  functions  are  associated  with  firing  ballistic  rounds  performed  in 
ml_weapons.c.  The  failure  of  the  main  gun  on  the  Ml  is  also  modeled  in  ml_weapons.c. 
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This  CSC  consists  of  three  CSU's: 


ml_bcs.c 

mljaser.c 

ml_weapons.c 


2.2.3. 1  inl_bcs.c 

(7sininei/release/src/vehicle/ml/src/ml_bcs.c  [nil_bcs.c]) 


The  Ml’s  ballistics  computer  is  simulated  by  this  file. 


Includes: 

"stdio.h" 

"math.h" 

"sim_types.h" 

"sim_(fe^ns.h" 

"sim_macros.h 

"basic.h" 

"mun_type.h" 

"timers.h" 

"timers_dfn.h" 

"Ubkin.h" 

"libmatrix.h" 

"libbalLh" 


ti 


If 


It 


ml_bcs.h" 

ml_tracks.h" 

ml_turret.h" 


Defines: 


Symbol 

Yaiug 

BCS  DEBUG 

FALSE 

BCS  NOT  CHANGING 

0.0 

BCS  INCREASING 

1.0 

BCS  DECREASING 

(-1.0) 

BCS_CHANGE_MASK 

3  manual:  the  bcs  changes 

every  4  frames 

HIGH  BCS  CHANGE  THRESHOLD 

76 

HIGH  BCS  CHANGE 

60.0 

LOW  BCS  CHANGE 

10.0 

MAX  BCS  SETTING 

4000.0 

MIN  BCS  SETTING 

200.0 

DEFAULT  BCS  RANGE 

1200.0 

BCS  BOOTUP  TIME 

2  seconds 

NUM  SLEW  ENTRIES 

15  ticks  (1.0  sec) 

493 


BBN  Systems  and  Technologies 


Vehicles  CSCI 


int  declarations: 

range_entered_manually 

bcs_manual_range_change 


bcs_change_elapsed 

bcs_bootup_timer 

bcs_booted„up 

flashing_zeros 

slew_rate_ptr 


TRUE  or  FALSE 
0  if  bcs  range  not  changing, 

1  if  bcs  range  is  increasing, 

-1  if  bcs  range  is  decreasing 
time  the  bcs  has  been  changing 

TRUE  or  FALSE 


REAL  declarations: 
bcs_range 
super_elevation 
le^azimuth 
gps_slew_rate 
flight_time 
apds_yb[10] 
apds_zb[10] 
heat_yb[10] 
heat_zb[10] 

slew_rate_buffer[NUM_SLEW_ENTRffiS] 


in  meters 
in  radians 
in  radians 
in  radians/sec 
in  seconds 

arrays  to  store  genbal  data 


ObjectType  declarations: 

ammo_type_selected 

char  declarations: 

bcs_range_str[80] 

Pointer  to  char  declarations  and  initialization: 
bcs_range_format  =  "%04d" 


2. 2. 3. 1.1  bcs_duinp_iead_buffer 

The  slew  rate  buffer  is  flushed  and  the  slew  rate  pointer  is  initialized. 


2.2.3. 1.2  bcs_init 

This  routine  initializes  the  ballistics  computer.  TTie  initial  bcs  range  is  set  to  1200  by  default. 
The  parameter  files  are  loaded. 


1  Calls  1 

Function 

Where  Described 

bcs  dump  lead,  buffer 

Section  2.2.3.1.1 

timers  set  null  timer 

Section  2.6.3.14.1 

ballistics  load  parameter  file 

Section  2.5.2.3.3 

Table  2.2-58:  bcs_init  Information. 
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2.2.3. 1.3  bcs_simul 

This  routine  simulates  the  bcs  system.  It  controls  the  operation  of  the  manual  battlesight. 

When  the  manual  bcs  button  is  pushed,  the  bcs  range  is  set  to  the  default  range(1200  meters). 
Pushing  the  add(drop)  switch  causes  the  bcs  range  to  be  increased  (decreased)  by  ten  meters. 

If  this  switch  is  held  down,  the  range  will  be  increased  (decreased)  nineteen  times  over  the  next 
five  seconds.  The  increase  (decrease)  is  in  increments  of  ten  meters.  If  the  switch  continues  to 
be  held  down  after  the  initial  five  seconds,  the  range  changes  at  the  same  rate  but  in  increments 
of  sixty  meters.  This  change  will  continue  until  the  range  reaches  the  maximum  (mininum) 
value  of  4000  meters  (200  meters). 

The  process  is  modelled  in  roughly  the  same  manner,  however,  the  events  are  timed  in  frames 
rather  than  seconds.  The  range  changes  once  every  four  frames  rather  than  19  times  in  five 
seconds. 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

abs  bcs  chanqe 

register  REAL 

Sim  types. h 

b  ranae 

pointer  to  register  REAL 

Sim.  types. h 

1  Calls  1 

Function 

Where  Described 

bcs  check  bootup 

Section  2.2.3.1.23 

max 

Sim  macros. h 

min 

Sim  macros.h 

. . . 

Section  2.2.6.1.1.4 

Table  2.2*59:  bcs  simul  Information. 


2 . 2 . 3 . 1 . 4  bcs_manual_range_battlesight 

This  routine  is  called  when  the  Battle  Sight  button  is  pushed.  It  sets  the  bcs  range  status  to 
manual. 

2 . 2 . 3 . 1 . 5  bcs_manual_range_add_pushed 

This  routine  is  called  when  the  Add  switch  is  depressed.  This  is  not  a  momentary  depression; 
the  switch  must  be  actively  released.  This  routine  increases  the  range  manually. 

2 . 2 . 3 . 1 . 6  bcs_manual_range_drop_pushed 

This  routine  is  called  when  the  Drop  switch  is  depressed.  This  is  not  a  momentary  depression; 
the  switch  must  be  actively  released  This  routine  decreases  the  range  manually. 

2 . 2 . 3 . 1 . 7  bcs_manual_range_released 

This  routine  is  called  when  the  Add  (Drop)  switch  is  released.  It  stops  the  range  from 
changing  further. 

2. 2. 3. 1.8  bcs  ammo  select  heat 
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This  routine  sets  the  ammo  type  when  heat  is  selected.  It  sets  ammo_type_selected  to 
munition_US  M456A1. 


2.2.3. 1.9  bcs_ammo_select_apds 

This  routine  sets  the  ammo  type  when  apds  is  selected.  It  sets  ammo_type_seIected  to 
munition_U  S_M392 A2. 


2.2.3.1.10  bcs_ammo_select_other 

This  routine  sets  the  ammo  type  when  other  is  selected.  It  sets  ammo_type_selected  to 
munition_U  S_M392 A2. 


2.2.3.1.11  bcs_range_is 

This  routine  is  called  to  clamp  the  new  range  whenever  the  laser  range  finder  determines  a  new 
value. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

range  from  Irf 

REAL 

Sim  types.h 

1  Internal  Variables  1 

Internal  Variable 

Where  Tvoedef  Declared 

b  range 

pointer  to  register  REAL 

Sim  types.h 

Table  2.2-60:  bcs_range_is  Information. 


2.2.3.1.12  calc_avg_slew_rate 
This  routine  returns  the  average  slew  rate. 


1  Internal  Variables  1 

Internal  Variable 

Type 

Where  Tvoedef  Declared 

i 

int 

Standard 

Slew  rate  sum 

REAL 

Sim  types.h 

1  Return  Values  1 

Return  Value 

slew  rate  sum/NUM  SLEW 
ENTRIES 

REAL 

The  average  slew  rate 

Table  2.2-61;  calc_avg_slew_rate  Information. 


2.2.3.1.13  bcs_set_baIIistics_computer 
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This  routine  performs  simulation  of  the  on-board  ballistics  computer.  It  calculates  actual  flight 
time  and  superelevation  of  any  projectile  given  the  bcs_range.  The  lead_azimuth  for  lead 
tracking  is  also  calculated. 


1  Errors  I 

Error  Name 

Reason  for  Error 

BCS:  Unknown  ammo  type  ... 
selected 

The  variable  ammo_type_selected  is  not  one  of  the  expected 
values. 

PANIC!?)  -  bcs  time  ==  0.0 

Projectile  fliqht  time  is  zero. 

Calls 

Function 

Where  Described 

ballistics  calc  time 

Section  2.5. 2. 1.1 

ballistics,  calc  se 

Section  2.5.2. 1.2 

eq 

tolerance.h 

calc  avq  slew  rate 

Section  2.2.3.1.12 

Table  2.2-62:  bcs_set_ballistics_c ’mputer  Information. 


2.2.3.1.14  bcs_get_lead_azimuth 
This  routine  returns  the  lead  azimuth. 


1  Return  Values  1 

Return  Value 

Meaning 

lead  azimuth 

REAL 

The  lead  azimuth 

Table  2.2-63:  bcs_get_lead_azimuth  Information. 


2.2.3.1.15  bcs_get_su per_ele vation 


This  routine  returns  the  super  elevation. 


1  Return  Values  1 

Return  Value 

Meaning 

super  elevation 

REAL 

The  super  elevation 

Table  2.2-64:  bcs_get_super_elevation  Information. 
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2.2.3.1.16  bcs_get_range 

This  routine  returns  the  ballistics  computer  system  range. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

bcs  ranae 

REAL 

The  bcs  range 

Table  2.2-65:  bcs_get_range  Information. 


2.2.3.1.17  bcs_get_time_of_flight 

This  routine  returns  the  time  of  flight  of  the  projectile. 


1  Return  Values  I 

Return  Value 

Meaning 

flight  time 

REAL 

The  time  of  flight 

Table  2.2-66:  bcs_get_time_of_flight  Information. 


2.2.3.1.18  bcs_get_ammo_type_indexed 
This  routine  returns  the  type  of  ammunition  selected. 


1  Return  Values  1 

Return  Value 

Meaning 

ammo  tvoe  selected 

ObiectTvoe 

The  selected  ammunition  type 

Table  2.2-67:  bcs_get_ammo_type_indexed  Information. 


2.2.3.1.19  bcs_get_range_str 

This  routine  is  called  by  the  graphics  interface  to  get  the  range  to  be  displayed  on  the  screen  of 
the  gunner's  view.  The  range  is  an  integer  rount^  to  the  nearest  10  meters. 


1  Internal  Variables  I 

Internal  Variable 

Type 

Where  Typedef  Declared 

flash  cnt 

int 

Standard 

1  Return  Values  1 

Return  Value 

Meaning  1 

bcs  range  str 

pointer  to  char 

Table  2.2-68:  bcs_get_range_str  Information. 


2.2.3  »  20  bcs_boot_computer 
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) 


lliis  routine  is  called  by  controls  to  boot  the  ballistics  computer  system  when  turret  power  is 
turned  on. 


1  Calls  1 

Function 

Where  Oescrlbed 

timers  aet  timer 

Section  2.6.3.6.1 

Table  2.2-69:  bcs_boot_computer  Information. 

2.2.3.1.21  bcs_computer_status 
This  routine  returns  the  computer  status. 


1  Return  Values  I 

Return  Value 

Type 

Meanina 

BCS  BOOTED  UP 

int 

bcs  booted  up  successfully. 

BCS  STILL  BOOTING 

int 

bcs  boot  in  process. 

BCS  OFF 

int 

bcs  has  not  booted  up. 

Calls 

Function 

Where  Described 

timers  qet  in  use  status 

Section  2.6.3.7.1 

Table  2.2-70:  bcs_computer_status  Information. 


2.2.3.1.22  bcs_turn_computer_off 

This  routine  turns  off  the  ballistics  computer  system.  This  routine  is  called  when  turret  power 
is  turned  off. 


I  Calls  I 

Function 

Where  Described 

timers  set  null  timer 

Section  2.6.3.14.1 

timers  free  timer 

Section  2.6.3.5.1 

Table  2.2-71:  bcs_turn_computer_off  Information. 
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2.2.3.1.23  bcs_check_bootup 

This  routine  checks  the  ballistics  computer  system  bootup. 


1  Calls  1 

Function 

Where  Described 

timers  qet  in  use  status 

Section  2.6.3.7.1 

timers  qet  tickinq  status 

Section  2.6.3.20.1 

timers  free  timer 

Section  2.6.3.5.1 

timers  set  null  timer 

Section  2.6.3.14.1 

Table  2.2-72:  bes  check_bootup  Information. 


